PATCH请求方法操作示例

本章节主要介绍PATCH请求方法中，“Merge Patch”与“Strategic Merge Patch”类型的操作示例。文中仅为示例，具体以实际为准。

操作示例

以创建Deployment资源对象为例。

请求示例

{
  "apiVersion": "cci/v2",
  "kind": "Deployment",
  "metadata": {
    "annotations": {
      "description": ""
    },
    "labels": {},
    "name": "nginx"
  },
  "spec": {
    "replicas": 2,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "annotations": {
          "vm.cci.io/pod-size-specs": "2.00_4.0",
          "resource.cci.io/pod-size-specs": "2.00_4.0",
        },
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "image": "library/nginx:stable-alpine-perl",
            "name": "container-0",
            "resources": {
              "limits": {
                "cpu": "2000m",
                "memory": "4096Mi"
              },
              "requests": {
                "cpu": "2000m",
                "memory": "4096Mi"
              }
            },
            "command": [],
            "lifecycle": {}
          }
        ],
        "dnsPolicy": "",
        "imagePullSecrets": [
          {
            "name": "imagepull-secret"
          }
        ],
        "dnsConfig": {}
      }
    },
    "minReadySeconds": 0,
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxSurge": 0,
        "maxUnavailable": 1
      }
    }
  }
}

响应示例

{
  "kind": "Deployment",
  "apiVersion": "cci/v2",
  "metadata": {
    "name": "nginx",
    "namespace": "zsqwkload2",
    "uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "resourceVersion": "1080724",
    "generation": 1,
    "creationTimestamp": "2024-04-30T08:48:10Z",
    "managedFields": []
  },
  "spec": {
    "replicas": 2,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        },
        "annotations": {
          "deployment.cci.io/pod-template-uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "resource.cci.io/pod-size-specs": "2.00_4.0",
          "vm.cci.io/pod-size-specs": "2.00_4.0"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "container-0",
            "image": "library/nginx:stable-alpine-perl",
            "resources": {
              "limits": {
                "cpu": "2",
                "memory": "4Gi"
              },
              "requests": {
                "cpu": "2",
                "memory": "4Gi"
              }
            },
            "lifecycle": {},
            "terminationMessagePath": "/dev/termination-log",
            "terminationMessagePolicy": "File"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "Default",
        "securityContext": {},
        "imagePullSecrets": [
          {
            "name": "imagepull-secret"
          }
        ],
        "schedulerName": "default-scheduler",
        "dnsConfig": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 0
      }
    },
    "progressDeadlineSeconds": 600
  },
  "status": {}
}

如果使用“Merge Patch”类型操作，添加一个容器到指定Deployment的“template”参数中，则其中的整个容器列表将被新添加的容器所替换。

Merge Patch请求

{
    "spec": {
        "template": {
            "spec": {
                "containers": [
                    {
                        "name": "hello-world",
                        "image": "busybox:latest"
                    }
                ]
            }
        }
    }
}

Merge Patch响应

{
  "kind": "Deployment",
  "apiVersion": "cci/v2",
  "metadata": {
    "name": "nginx",
    "namespace": "zsqwkload2",
    "uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "resourceVersion": "1080882",
    "generation": 2,
    "creationTimestamp": "2024-04-30T08:51:37Z",
    "annotations": {
      "deployment.kubernetes.io/revision": "1",
      "description": "",
      "tenant.cci.io/tenant-id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "managedFields": []
  },
  "spec": {
    "replicas": 2,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        },
        "annotations": {
          "deployment.cci.io/pod-template-uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "resource.cci.io/pod-size-specs": "2.00_4.0",
          "vm.cci.io/pod-size-specs": "2.00_4.0"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "hello-world",
            "image": "busybox:latest",
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "terminationMessagePolicy": "File"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "Default",
        "securityContext": {},
        "imagePullSecrets": [
          {
            "name": "imagepull-secret"
          }
        ],
        "schedulerName": "default-scheduler",
        "dnsConfig": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 0
      }
    },
    "progressDeadlineSeconds": 600
  },
  "status": {
    "observedGeneration": 1,
    "replicas": 2,
    "updatedReplicas": 2,
    "unavailableReplicas": 2,
    "conditions": [
      {
        "type": "Available",
        "status": "False",
        "lastUpdateTime": "2024-04-30T08:51:37Z",
        "lastTransitionTime": "2024-04-30T08:51:37Z",
        "reason": "MinimumReplicasUnavailable",
        "message": "Deployment does not have minimum availability."
      },
      {
        "type": "Progressing",
        "status": "True",
        "lastUpdateTime": "2024-04-30T08:51:37Z",
        "lastTransitionTime": "2024-04-30T08:51:37Z",
        "reason": "ReplicaSetUpdated",
        "message": "ReplicaSet \"nginx-78f5ff5dff\" is progressing."
      }
    ]
  }
}

其中“containers”参数列表被新添加的内容所替换。

而使用“Strategic Merge Patch”类型操作，是添加元数据到资源对象中，并通过这些新元数据来决定各个列表是否需要被合并。

Strategic Merge Patch请求

{
    "spec": {
        "template": {
            "spec": {
                "containers": [
                    {
                        "name": "hello-world22",
                        "image": "busybox:latest"
                    }
                ]
            }
        }
    }
}

Strategic Merge Patch响应

{
  "kind": "Deployment",
  "apiVersion": "cci/v2",
  "metadata": {
    "name": "nginx",
    "namespace": "zsqwkload2",
    "uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "resourceVersion": "1080952",
    "generation": 3,
    "creationTimestamp": "2024-04-30T08:51:37Z",
    "annotations": {
      "deployment.kubernetes.io/revision": "2",
      "description": "",
      "tenant.cci.io/tenant-id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "managedFields": []
  },
  "spec": {
    "replicas": 2,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        },
        "annotations": {
          "deployment.cci.io/pod-template-uid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "resource.cci.io/pod-size-specs": "2.00_4.0",
          "vm.cci.io/pod-size-specs": "2.00_4.0"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "hello-world22",
            "image": "busybox:latest",
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "terminationMessagePolicy": "File"
          },
          {
            "name": "hello-world",
            "image": "busybox:latest",
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "terminationMessagePolicy": "File"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "Default",
        "securityContext": {},
        "imagePullSecrets": [
          {
            "name": "imagepull-secret"
          }
        ],
        "schedulerName": "default-scheduler",
        "dnsConfig": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 0
      }
    },
    "progressDeadlineSeconds": 600
  },
  "status": {
    "observedGeneration": 2,
    "replicas": 2,
    "updatedReplicas": 1,
    "readyReplicas": 1,
    "availableReplicas": 1,
    "unavailableReplicas": 1,
    "conditions": [
      {
        "type": "Available",
        "status": "True",
        "lastUpdateTime": "2024-04-30T08:52:57Z",
        "lastTransitionTime": "2024-04-30T08:52:57Z",
        "reason": "MinimumReplicasAvailable",
        "message": "Deployment has minimum availability."
      },
      {
        "type": "Progressing",
        "status": "True",
        "lastUpdateTime": "2024-04-30T08:52:57Z",
        "lastTransitionTime": "2024-04-30T08:51:37Z",
        "reason": "ReplicaSetUpdated",
        "message": "ReplicaSet \"nginx-5dc68ffd6d\" is progressing."
      }
    ]
  }
}

其中“containers”参数列表与新添加的内容合并，而不是替换，合并的依据为“name”域的值。

父主题： 附录

上一篇：PATCH请求方法操作说明

下一篇：Namespace和Network

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

PATCH请求方法操作示例

操作示例

相关文档

意见反馈

文档内容是否对您有帮助？