当前位置：首页 > news >正文

AIP-128 声明友好接口

news 来源：原创 2025/5/24 21:27:50

编号	128
原文链接	AIP-128: Declarative-friendly interfaces
状态	批准
创建日期	2020-10-06
更新日期	2020-10-06

许多服务需要与常见的DevOps工具交互，特别是创建和管理可网络寻址资源（如虚拟机、负载均衡器、数据库实例等）的工具。这些工具采用“配置即代码”原则：用户设定一个完整的目标状态，工具负责执行必要的操作，实现用户设定的规范。

这些工具是 声明式 的：不指定具体要执行的操作，而是指定期望的目标。操作是根据当前状态与目标状态之间的差异推导出来的。

此外，流行的DevOps工具数量众多，每年又会出现大量的新工具。将数百种资源类型与多个工具进行集成，需要统一接口，以便自动执行集成工作。

指南

资源

声明友好资源必须始终使用标准方法管理资源生命周期，这将允许工具广泛支持这些资源，同时也符合声明友好指南的其他要求（参考进一步阅读）。

声明友好资源应该指明其遵守声明友好风格：

message Book {option (google.api.resource) = {type: "library.googleapis.com/Book"pattern: "publishers/{publisher}/books/{book}"style: DECLARATIVE_FRIENDLY};// Name and other fields...
}

协调

如果更新资源需要较长时间（超过几秒），资源应该包含一个 bool reconciling 域，告知更改正在进行。这个域必须是仅输出的。

如果资源的当前状态与用户预期的状态不一致，并且系统正在协调处理，资源必须将 reconciling 域设置为 true ，无论开始协调的根本原因是用户操作或系统动作。

注意： 处理 GET 请求的服务必须返回资源的当前状态（而非预期状态）。

进一步阅读

关于声明友好接口存在大量更严格的指南，因为它关注于对资源的自动化操作。下面的列表是其他AIPs中关于声明友好接口指南的汇总：

资源不应使用自定义方法：参考AIP-136。
资源必须使用 UPDATE 方法处理重复域：参考AIP-144。
资源必须包含特定的标准域：参考AIP-148。
资源必须具有 etag 域：参考AIP-154。
资源应该提供验证更改的方法：参考AIP-163。
资源不应实现软删除。如果资源标识不能重复使用，资源必须实现软删除和撤销删除RPC：参考AIP-164。

注解

参考AIP-148注解。

修订记录

2023-07-13 将 annotations 移动到AIP-148。
2023-06-17 删除关于平面的定义，移动到AIP-111。
2023-05-11 删除对resource_id域的“必须”要求，该要求已移动到通用的“必须”规范中。

AIP-128 声明友好接口

编号128原文链接AIP-128: Declarative-friendly interfaces状态批准创建日期2020-10-06更新日期2020-10-06 许多服务需要与常见的DevOps工具交互，特别是创建和管理可网络寻址资源（如虚拟机、负载均衡器、数据库实例等）的工具。这些工具采用“…...

编程日记 2025/5/24 21:27:50

【Jave全栈】Java与JavaScript比较

文章目录前言一、Java1、历史与背景2、语言特点3、应用场景4、生态系统二、JavaScript1、历史与背景2、语言特点3、应用场景4、生态系统三、相同点四、不同点1、语言类型2、用途3、语法和结构4、性能5、生态系统6、开发模式前言 Java和JavaScript是两种不同的编程语言&a…...

编程日记 2025/5/24 20:32:15

钉钉群机器人设置——python版本

钉钉群机器人设置——python版本应用场景钉钉界面操作程序开发效果展示应用场景由于工作需要，很多项目执行程序后出现报错信息无法第一时间收到，因此实时预警对于监控程序还是有必要。（仅个人观点） 参考文档及博客&#xff1a…...

编程日记 2025/5/24 19:53:16

报错：{‘csrf_token‘: [‘The CSRF token is missing.‘]}

flask实现一个简单的注册界面报错 register.html <!DOCTYPE html> <html lang"en"> <head><meta charset"UTF-8"><title>Title</title> </head> <body> <form action"" method"post&…...

编程日记 2025/5/23 5:08:42

STM32新建不同工程的方式

新建工程的方式 1. 安装开发工具 MDK5 / keil52. CMSIS 标准3. 新建工程3.1 寄存器版工程3.2 标准库版工程3.3 HAL/LL库版工程3.4 HAL库、LL库、标准库和寄存器对比3.5 库开发和寄存器的关系 4. STM32CubeMX工具的作用 1. 安装开发工具 MDK5 / keil5 MDK5 由两个部分组成&#…...

编程日记 2025/5/22 21:11:43

Java数据库操作指南：快速上手JDBC【学术会议-2025年数字化教育与信息技术（DEIT 2025】

大会官网：www.ic-deit.org 前言在现代企业应用中，数据库是数据存储和管理的重要组成部分。Java作为一种广泛使用的编程语言，提供了多种方式与数据库进行交互。本文将介绍 JDBC（Java Database Connectivity）&#x…...

编程日记 2025/5/24 20:27:25

基于Springboot + vue实现的在线装修管理系统

“前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到网站：人工智能学习网站” 💖学习知识需费心， 📕整理归纳更费神。 🎉源码免费人人喜…...

编程日记 2025/5/24 20:42:19

计算机网络之应用层

本文章目录结构出自于《王道计算机考研计算机网络_哔哩哔哩_bilibili》 05 应用层在网上看到其他人做了相关笔记，就不再多余写了，直接参考着学习吧。王道考研计算机网络笔记第六章：应用层_王道考研应用层笔记-CSDN博客 DNS&#x…...

编程日记 2025/5/24 20:24:00

SpringMVC框架

第1章 SpringMVC入门 1.1 SpringMVC简介 Spring MVC 全称:Spring Web MVC是 Spring 框架的一部分，专注于实现 Web 应用程序的模型-视图-控制器（Model-View-Controller, MVC）设计模式。它为构建灵活且松耦合的 Web 应用提供了强大的功能&…...

编程日记 2025/5/24 20:29:11

将 OneLake 数据索引到 Elasticsearch - 第 1 部分

作者：来自 Elastic Gustavo Llermaly 学习配置 OneLake，使用 Python 消费数据并在 Elasticsearch 中索引文档，然后运行语义搜索。 OneLake 是一款工具，可让你连接到不同的 Microsoft 数据源，例如 Power BI、Data Activ…...

编程日记 2025/5/24 20:57:16

flutter跨端UI框架简介

flutter跨端UI框架简介简介 Flutter是由Google开发的开源应用开发框架，主要用于构建高性能、跨平台的移动、Web和桌面应用程序。Flutter使用Dart语言，提供了一套丰富的Widgets，使开发者能够快速创建美观的用户界面。其最大特点是热重载功能…...

编程日记 2025/5/13 12:10:08

Centos 修改历史读录( HISTSIZE)

history命令 -c #清空命令历史 -r #读历史文件附加到历史列表 -w #保存历史列表到指定的历史文件命令历史相关环境变量 HISTSIZE #命令历史记录的条数 HISTFILE #指定历史文件，默认为~/.bash_history HISTFILESIZE #命令历史文件记录历史的条数以上变量可以 exp…...

编程日记 2025/5/19 18:34:24

利用ML.NET精准提取人名

在当今信息爆炸的时代，文本处理任务层出不穷，其中人名提取作为基础且重要的工作，广泛应用于信息检索、社交网络分析、客户关系管理等领域。随着人工智能不断进步，ML.NET作为微软推出的开源机器学习框架，为开发者提供了…...

编程日记 2025/5/24 19:56:19

关于deepin上运行Qt开发的程序

国产化替代是将来各单位的主流趋势，探索自行开发应用程序在国产操作系统上正常运行是将来的主要工作之一。本文浅尝gui程序在统信社区版——deepin上遇到的小问题。使用Qt在deepin上做了一个类似gif的帧动画弹窗，在编译运行时，程序可以正常…...

编程日记 2025/5/24 20:08:27

3.3 Go函数可变参数

可变参数（variadic parameters）是一种允许函数接受任意数量参数的机制。它在函数定义中使用 ...type 来声明参数类型，所有传递的参数会被收集为一个切片，函数内部可以像操作普通切片一样处理这些参数。 package mainimport "…...

编程日记 2025/5/18 7:58:41

Queries Acceleration -Tuning- Tuning Execution 学习笔记

1 Adjustment of RuntimeFilter Wait Time 1.1 Case: Too Short RuntimeFilter Wait Time 1.1.1 没有看懂，好像是等待时间过小也会导致性能下降 1.1.2 set runtime_filter_wait_time_ms = 3000; 2 Data Skew Handling 2.1 Case 1: Bucket Data Skew Leading to Suboptimal …...

编程日记 2025/5/24 1:13:29

VS C++ 配置OPENCV环境

VS C 配置OPENCV环境 1.下载opencv2.安装环境3.opencv环境4.VS配置opencv环境5.EXE执行文件路径的环境lib和dll需要根据是debug还是release环境来区分使用哪个 6.Windows环境 1.下载opencv 链接: link 2.安装环境双击运行即可 3.opencv环境 include文件路径:opencv\build\…...

编程日记 2025/5/21 5:58:26

Midscene.js：重新定义UI自动化的新时代工具

前言 Midscene.js 是一个创新的、面向开发者的 UI 自动化解决方案，并通过人工智能技术简化自动化脚本的编写与维护。它提供了三种核心方法——交互（.ai, .aiAction）、提取（.aiQuery）和断言（.aiAssert&am…...

编程日记 2025/5/23 7:40:35

记录让cursor帮我给ruoyi-vue后台管理项目整合mybatis-plus

自己整合过程中会出现 work.web.exception.GlobalExceptionHandler :100 | 请求地址/admin/device/install/detail/1,发生未知异常. org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.fire.mapper.DeviceInstallMapper.selectById at o…...

编程日记 2025/5/19 11:48:18

uniapp中h5的微应用解决办法

考虑过用wujie，参考官网Vue组件封装 | 无界的教程，虽然没报错，但是子应用的vue节点根本没挂载上，不知道什么原因，如下图所示后面采用iframe方式将子应用导入进来： 父应用： <template>&…...

编程日记 2025/5/24 20:44:14

再尝Semantic Kernel，planning特性很香

背景书接上回《浅尝semantic kernel》； 上次只试了试SK框架的插件特性，这次试了下编排的特性，也就是把多个本地任务按顺序按逻辑执行，没想到效果也是出奇的好！ 关键步骤架构层面的代码本篇不在赘述，这…...

编程日记 2025/5/21 8:02:41

华为OD机试真题---战场索敌

华为OD机试真题“战场索敌”是一道考察算法和数据结构应用能力的题目。以下是对该题目的详细解析： 一、题目描述有一个大小是NM的战场地图，被墙壁’#‘分隔成大小不同的区域。上下左右四个方向相邻的空地’.‘属于同一个区域，只有空地上可…...

编程日记 2025/5/24 21:01:01

Case逢无意难休——深度解析JAVA中case穿透问题

Case逢无意难休——深度解析JAVA中case穿透问题~ 不作溢美之词，不作浮夸文章，此文与功名进取毫不相关也！与大家共勉！！ 更多文章：个人主页系列文章：JAVA专栏欢迎各位大佬来访哦~互三必回&#…...

编程日记 2025/5/24 20:51:04

HTML入门知识

目录一、什么是HTML 二、HTML文档的语法规则三、HTML基本标签四、HTML注释与特殊字符 1、注释 2、特殊字符五、HTML属性六、常见误区与建议一、什么是HTML HTML，全称Hyper Text Markup Language，即超文本标记语言，是一种用于创…...

编程日记 2025/5/24 21:17:43

idea maven本地有jar包，但还要从远程下载

idea 中，java 工程执行 maven reimport，报jar报无法下载。我奇了个怪，我明明在本地仓库有啊，你非得从远程下载？ 我从供应商那里拿来的，远程当然没有了。这太奇葩了吧，折腾好久不行。后来…...

编程日记 2025/5/21 8:31:40

利用大语言模型（LLM）增强软件测试自动化的最佳实践

在当今迅速变化的科技时代，软件测试行业面临着越来越高的效率和质量要求。作为测试专家，我们都知道，传统的测试方法往往无法满足快速迭代和高效交付的需求。在这种背景下，自动化测试逐渐成为解决方案的一部分。而大语言模型&#…...

编程日记 2025/5/22 21:07:34

联想电脑怎么设置u盘启动_联想电脑设置u盘启动方法(支持新旧机型)

有很多网友问联想电脑怎么设置u盘启动，联想电脑设置u盘启动的方法有两种，一是通过bios进行设置。二是通过快捷方式启动进入u盘启动。但需要注意有两种引导模式是，一种是uefi引导，一种是传统的leacy引导，所以需要注意制…...

编程日记 2025/5/14 22:09:10

Browser-Use WebUI项目启动指南

摘要此前发布《Browser - Use WebUI 使用体验》博文后，鉴于部分朋友运行时出现问题，重新运行并整理相关内容。本文详细记录 Web UI 项目启动全过程，涵盖 Python 3.11、Chrome 浏览器及 API Keys 等环境要求，Python 环境检查、依赖…...

编程日记 2025/5/19 8:17:04

期权帮｜如何利用股指期货进行对冲套利？

锦鲤三三每日分享期权知识，帮助期权新手及时有效地掌握即市趋势与新资讯！ 如何利用股指期货进行对冲套利？ 对冲就是通过股指期货来平衡投资组合的风险。它分为正向与反向两种策略： （1）正向对冲&#xff…...

编程日记 2025/5/20 8:06:42

基于springboot的酒店客房管理系统----数据库课程设计

目录 1.需求分析 1.1用例模型 1.1.1用例图 1.1.2用例描述 1.2过程模型 1.2.1数据流 1.2.2数据字典 1.3 安全性和完整性需求 1.4?数据字典 1.4.1数据项 1.4.2数据结构 1.4.3数据流 1.4.4数据存储 1.4.5数据过程 2概念结构设计 2.1 ER模型 2.1.1 实体及属性 2…...

编程日记 2025/5/23 8:44:36

SPDK vhost介绍

目录 1. vhost技术的背景与动机Virtio 介绍virtio-blk数据路径为例 2. vhost技术的核心原理2.1 vhost-kernel2.2 vhost-user举例 2.3 SPDK vhostvhost的优势IO请求处理数据传输控制链路调整 3. SPDK vhost的实现与配置3.1 环境准备3.2 启动SPDK vhost服务3.3 创建虚拟块设备3.4…...

编程日记 2025/5/24 1:58:32

理解C++运行时类型识别符: typeid

1. 格式 typeid (type-id) typeid (expression) typeid 运算符允许在运行时确定对象的类型。 typeid 的结果是一个 const type_info&。该值是对 type_info 对象的引用，该对象表示 type-id 或表达式的类型，具体取决于使用哪种形式的 typeid。有关…...

编程日记 2025/5/21 7:01:47

Fullcalendar @fullcalendar/react 样式错乱丢失问题和导致页面卡顿崩溃问题

问题描述： 我使用 fullcalendar的react版本时，出现了一个诡异的问题，当我切换到一个iframe页面时（整个页面是一个iframe嵌入的），再切换回来日历的样式丢失了！不仅丢失了样式还导致页面崩溃了&…...

编程日记 2025/5/22 10:07:18

C++从入门到实战（二）C++命名空间

C从入门到实战（二）C命名空间前言一、C的第一个程序二、命名空间（一）为什么需要命名空间（二）定义命名空间（三）使用命名空间1.通过命名空间限定符：2.使用 using 声明&…...

编程日记 2025/5/20 2:55:19

Spring 定时任务：@Scheduled 注解四大参数解析

本文主要介绍了在 Spring 框架中使用Scheduled注解实现定时任务的方法，重点讲解了fixedRate、fixedDelay、cron和initialDelay这四个参数的用法，并通过实例代码进行了详细说明。 1. fixedRate 参数参数含义 fixedRate指定任务固定时间间隔执行。如设…...

编程日记 2025/5/19 22:29:27

计算机网络之物理层

本文章目录结构出自于《王道计算机考研计算机网络_哔哩哔哩_bilibili》 01 物理层在网上看到其他人做了详细的笔记，就不再多余写了，直接参考着学习吧。 1 详解物理层-通信基础【王道计算机网络笔记】_wx63088f6683f8f的技术博客_51CTO博客 2 详解物…...

编程日记 2025/5/22 13:22:58

Oracle 数据库常见字段类型大全及详细解析

在工作期间会遇到数据库建表的业务，经常会使用复制粘帖等操作，而不清楚数据库的字段类型。本文记录了 Oracle 数据库常见字段类型，根据不同的数据需求，可以选择不同的字段类型来存储数据。文章目录一、字符类型（Char…...

编程日记 2025/5/19 14:16:54

总线、UART、IIC、SPI

一图流总线概念连接多个部件的信息传输线，是各部件共享的传输介质类型片内总线：连接处理器内核和外设的总线，在芯片内部片外总线：连接芯片和其他芯片或者模块的总线总线的通信总线通信的方式串行通信数据按位顺序传…...

编程日记 2025/5/19 19:40:11

纯css实现div宽度可调整

<!DOCTYPE html> <html lang"en"><head><meta charset"UTF-8" /><meta name"viewport" content"widthdevice-width, initial-scale1.0" /><title>纯css实现div尺寸可调整</title><style…...

编程日记 2025/5/24 0:07:20

Arduino大师练成手册 -- 读取DHT11

要在 Arduino 上控制 DHT11 温湿度传感器，你可以按照以下步骤进行： 硬件连接： 将 DHT11 的 VCC 引脚连接到 Arduino 的 5V 引脚。将 DHT11 的 GND 引脚连接到 Arduino 的 GND 引脚。将 DHT11 的 DATA 引脚连接到 Arduino 的数字引脚&am…...

编程日记 2025/5/19 5:20:22

GS论文阅读--GeoTexDensifier

前言本文是一个关于高斯致密化策略对高斯地图进行优化，他主要关注了几何结构和纹理信息。我最近对于高斯点的分布比较感兴趣，因为高斯点的分布决定了之后重建质量的好坏，初始化高斯很重要，但之后的维护需要致密化与修建策略&…...

编程日记 2025/5/24 10:50:43

Android实战经验篇-玩转Selinux(详解版)

列文章转如下链接： Android Display Graphics系列文章-汇总 Android实战经验篇-系列文章汇总本文主要包括部分： 一、Selinux概述 1.1 SELinux是什么？ 1.2 自主访问控制（DAC） 1.3 强制访问控制（MAC&…...

编程日记 2025/5/22 21:11:45

【langgraph】ubuntu安装：langgraph：未找到命令

langgraph 在ubuntu24.04 参考：langgraph运行：报错： (05_ep_dev) root@k8s-master-pfsrv:/home/zhangbin/perfwork/01_ai/05_ep_dev/expert# langgraph dev langgraph：未找到命令查看langraph的安装情况 pip show langgraph...

编程日记 2025/5/17 7:48:21

深入探究分布式日志系统 Graylog：架构、部署与优化

文章目录一、Graylog简介二、Graylog原理架构三、日志系统对比四、Graylog部署传统部署MongoDB部署OS或者ES部署Garylog部署容器化部署五、配置详情六、优化网络和 REST APIMongoDB 七、升级八、监控九、常见问题及处理一、Graylog简介 Graylog是一个简单易用、功能较全面的…...

编程日记 2025/5/21 13:44:09

HTML新春烟花

系列文章序号目录1HTML满屏跳动的爱心（可写字）2HTML五彩缤纷的爱心3HTML满屏漂浮爱心4HTML情人节快乐5HTML蓝色爱心射线6HTML跳动的爱心（简易版）7HTML粒子爱心8HTML蓝色动态爱心9HTML跳动的爱心（双心版）1…...

编程日记 2025/5/16 13:25:08

CentOS 7 安装fail2ban hostdeny方式封禁ip —— 筑梦之路

centos 7 换源参考CentOS 7.9 停止维护(2024-6-30)后可用在线yum源 —— 筑梦之路_centos停止维护-CSDN博客安装fail2ban yum install fail2ban 新增配置文件 cat > /etc/fail2ban/action.d/hostsdeny.conf << EOF [Definition] actionstart actionstop action…...

编程日记 2025/5/20 2:26:03

java入门基础笔记语法篇（3）

一、注释什么是注释注释定义：注释是写在程序中对代码进行解释说明的文字，方便自己和他人查看以理解程序。 Java注释的三种写法： 单行注释：以“//”开头，注释内容只能写一行。多行注释：以“/*”开头&…...

编程日记 2025/5/22 10:34:27

VUE对接deepseekAPI调用

1.先去开放平台注册账号申请api key。开放平台：https://platform.deepseek.com/api_keys 2.你的项目需要有发送请求的axios或者自己写。 npm install axios # 或 yarn add axios 3.创建 API 调用函数在 Vue 项目中，通常会将 API 调用的逻辑封装到一个…...

编程日记 2025/5/19 20:40:13

【C++高并发服务器WebServer】-1：Linux中父子进程fork创建及关系、GDB多进程调试

本文目录一、进程创建二、GDB多进程调试一、进程创建在Linux中输入man 2 fork可以查看man文档中的fork的相关函数信息。 fork的作用就是创建一个子进程。通过fork我们可以知道，创建子进程的时候，复制父进程的信息。我们看看翻译的man文档信息&am…...

编程日记 2025/5/23 8:11:33

leetcode——相交链表（java）

给你两个单链表的头节点 headA 和 headB ，请你找出并返回两个单链表相交的起始节点。如果两个链表不存在相交节点，返回 null 。图示两个链表在节点 c1 开始相交： 题目数据保证整个链式结构中不存在环。注意，函数返回结果后&…...

编程日记 2025/5/23 7:44:24

指南

资源

协调

进一步阅读

注解

修订记录

相关文章：