Azure / azure-rest-api-specs

The source for REST API specifications for Microsoft Azure.
MIT License
2.68k stars 5.1k forks source link

`Microsoft.ContainerService/managedClusters@2022-09-02-preview` - `ROUNDTRIP_MISSING_PROPERTY` #21850

Open ms-henglu opened 1 year ago

ms-henglu commented 1 year ago

Microsoft.ContainerService/managedClusters@2022-09-02-preview - ROUNDTRIP_MISSING_PROPERTY

Description

I found differences between PUT request body and GET response:

{
    "properties": {
        "agentPoolProfiles": [
            {
                "count": 1,
                "mode": "System",
                "name": "default",
                "vmSize": "Standard_D2_v2"
            }
        ],
        "dnsPrefix": "henglu1123aks",
        "guardrailsProfile": {
            "excludedNamespaces": [ is not returned from response
                "default" is not returned from response
            ] is not returned from response,
            "level": "Warning",
            "version": "1.0"
        }
    }
}

Details

  1. ARM Fully-Qualified Resource Type

    Microsoft.ContainerService/managedClusters
  2. API Version

    2022-09-02-preview
  3. Swagger issue type

    Swagger Correctness
  4. OperationId

    TODO
    e.g., VirtualMachines_Get
  5. Swagger GitHub permalink

    TODO, 
    e.g., https://github.com/Azure/azure-rest-api-specs/blob/60723d13309c8f8060d020a7f3dd9d6e380f0bbd
    /specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json#L9065-L9101
  6. Error code

    ROUNDTRIP_MISSING_PROPERTY
  7. Request traces

    
    PUT https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks?api-version=2022-09-02-preview
    Accept: application/json
    Authorization: REDACTED
    Content-Length: 287
    Content-Type: application/json
    User-Agent: HashiCorp Terraform/1.2.8 (+https://www.terraform.io) Terraform Plugin SDK/2.8.0 terraform-provider-azapi/v1.1.0 pid-222c6c49-1b0a-5959-a213-6608f9eb8820
    X-Ms-Correlation-Request-Id: REDACTED
    --------------------------------------------------------------------------------
    {"identity":{"type":"SystemAssigned"},"location":"westeurope","properties":{"agentPoolProfiles":[{"count":1,"mode":"System","name":"default","vmSize":"Standard_D2_v2"}],"dnsPrefix":"henglu1123aks","guardrailsProfile":{"excludedNamespaces":["default"],"level":"Warning","version":"1.0"}}}
    --------------------------------------------------------------------------------

RESPONSE Status: 200 OK Azure-Asyncoperation: REDACTED Cache-Control: no-cache Content-Type: application/json Date: Mon, 12 Dec 2022 06:42:20 GMT Expires: -1 Pragma: no-cache Server: nginx Strict-Transport-Security: REDACTED Vary: REDACTED X-Content-Type-Options: REDACTED X-Ms-Correlation-Request-Id: REDACTED X-Ms-Ratelimit-Remaining-Subscription-Writes: REDACTED X-Ms-Request-Id: e1a64eda-80a0-4d35-8466-1a17d0031d04 X-Ms-Routing-Request-Id: REDACTED

{ "id": "/subscriptions/{subscription_id}/resourcegroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks", "location": "westeurope", "name": "henglu1123aks", "type": "Microsoft.ContainerService/ManagedClusters", "properties": { "provisioningState": "Updating", "powerState": { "code": "Running" }, "kubernetesVersion": "1.23.12", "currentKubernetesVersion": "1.23.12", "dnsPrefix": "henglu1123aks", "fqdn": "henglu1123aks-7f5bb856.hcp.westeurope.azmk8s.io", "azurePortalFQDN": "henglu1123aks-7f5bb856.portal.hcp.westeurope.azmk8s.io", "agentPoolProfiles": [ { "name": "default", "count": 1, "vmSize": "Standard_D2_v2", "osDiskSizeGB": 128, "osDiskType": "Managed", "kubeletDiskType": "OS", "maxPods": 110, "type": "VirtualMachineScaleSets", "provisioningState": "Updating", "powerState": { "code": "Running" }, "orchestratorVersion": "1.23.12", "currentOrchestratorVersion": "1.23.12", "enableCustomCATrust": false, "mode": "System", "osType": "Linux", "osSKU": "Ubuntu", "nodeImageVersion": "AKSUbuntu-1804containerd-2022.11.02", "enableFIPS": false } ], "servicePrincipalProfile": { "clientId": "msi" }, "nodeResourceGroup": "MC_henglu1123aks_henglu1123aks_westeurope", "enableRBAC": true, "networkProfile": { "networkPlugin": "kubenet", "loadBalancerSku": "Standard", "loadBalancerProfile": { "managedOutboundIPs": { "count": 1 }, "effectiveOutboundIPs": [ { "id": "/subscriptions/{subscription_id}/resourceGroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.Network/publicIPAddresses/815c3edf-76ef-404a-8831-74ab22acff81" } ], "backendPoolType": "nodeIPConfiguration" }, "podCidr": "10.244.0.0/16", "serviceCidr": "10.0.0.0/16", "dnsServiceIP": "10.0.0.10", "dockerBridgeCidr": "172.17.0.1/16", "outboundType": "loadBalancer", "podCidrs": [ "10.244.0.0/16" ], "serviceCidrs": [ "10.0.0.0/16" ], "ipFamilies": [ "IPv4" ] }, "maxAgentPools": 100, "identityProfile": { "kubeletidentity": { "resourceId": "/subscriptions/{subscription_id}/resourcegroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.ManagedIdentity/userAssignedIdentities/henglu1123aks-agentpool", "clientId": "4792bfea-94be-4ee3-8a8b-3a708935370b", "objectId": "e90976bf-c820-453c-865c-dc8be5a681e3" } }, "securityProfile": {}, "storageProfile": { "diskCSIDriver": { "enabled": true, "version": "v1" }, "fileCSIDriver": { "enabled": true }, "snapshotController": { "enabled": true } }, "oidcIssuerProfile": { "enabled": false }, "guardrailsProfile": { "level": "Warning", "version": "1.0" }, "workloadAutoScalerProfile": {} }, "identity": { "type": "SystemAssigned", "principalId": "0065de10-233b-431d-8de9-4bf5f4661944", "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" }, "sku": { "name": "Basic", "tier": "Free" } }

GET https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks?api-version=2022-09-02-preview Accept: application/json Authorization: REDACTED User-Agent: HashiCorp Terraform/1.2.8 (+https://www.terraform.io) Terraform Plugin SDK/2.8.0 terraform-provider-azapi/v1.1.0 pid-222c6c49-1b0a-5959-a213-6608f9eb8820 X-Ms-Correlation-Request-Id: REDACTED

RESPONSE Status: 200 OK Cache-Control: no-cache Content-Type: application/json Date: Mon, 12 Dec 2022 06:43:52 GMT Expires: -1 Pragma: no-cache Server: nginx Strict-Transport-Security: REDACTED Vary: REDACTED X-Content-Type-Options: REDACTED X-Ms-Correlation-Request-Id: REDACTED X-Ms-Ratelimit-Remaining-Subscription-Reads: REDACTED X-Ms-Request-Id: 00177587-dba4-4c7d-b5f2-9d3dcb68775c X-Ms-Routing-Request-Id: REDACTED

{ "id": "/subscriptions/{subscription_id}/resourcegroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks", "location": "westeurope", "name": "henglu1123aks", "type": "Microsoft.ContainerService/ManagedClusters", "properties": { "provisioningState": "Succeeded", "powerState": { "code": "Running" }, "kubernetesVersion": "1.23.12", "currentKubernetesVersion": "1.23.12", "dnsPrefix": "henglu1123aks", "fqdn": "henglu1123aks-7f5bb856.hcp.westeurope.azmk8s.io", "azurePortalFQDN": "henglu1123aks-7f5bb856.portal.hcp.westeurope.azmk8s.io", "agentPoolProfiles": [ { "name": "default", "count": 1, "vmSize": "Standard_D2_v2", "osDiskSizeGB": 128, "osDiskType": "Managed", "kubeletDiskType": "OS", "maxPods": 110, "type": "VirtualMachineScaleSets", "provisioningState": "Succeeded", "powerState": { "code": "Running" }, "orchestratorVersion": "1.23.12", "currentOrchestratorVersion": "1.23.12", "enableCustomCATrust": false, "mode": "System", "osType": "Linux", "osSKU": "Ubuntu", "nodeImageVersion": "AKSUbuntu-1804containerd-2022.11.02", "enableFIPS": false } ], "servicePrincipalProfile": { "clientId": "msi" }, "nodeResourceGroup": "MC_henglu1123aks_henglu1123aks_westeurope", "enableRBAC": true, "networkProfile": { "networkPlugin": "kubenet", "loadBalancerSku": "Standard", "loadBalancerProfile": { "managedOutboundIPs": { "count": 1 }, "effectiveOutboundIPs": [ { "id": "/subscriptions/{subscription_id}/resourceGroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.Network/publicIPAddresses/815c3edf-76ef-404a-8831-74ab22acff81" } ], "backendPoolType": "nodeIPConfiguration" }, "podCidr": "10.244.0.0/16", "serviceCidr": "10.0.0.0/16", "dnsServiceIP": "10.0.0.10", "dockerBridgeCidr": "172.17.0.1/16", "outboundType": "loadBalancer", "podCidrs": [ "10.244.0.0/16" ], "serviceCidrs": [ "10.0.0.0/16" ], "ipFamilies": [ "IPv4" ] }, "maxAgentPools": 100, "identityProfile": { "kubeletidentity": { "resourceId": "/subscriptions/{subscription_id}/resourcegroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.ManagedIdentity/userAssignedIdentities/henglu1123aks-agentpool", "clientId": "4792bfea-94be-4ee3-8a8b-3a708935370b", "objectId": "e90976bf-c820-453c-865c-dc8be5a681e3" } }, "securityProfile": {}, "storageProfile": { "diskCSIDriver": { "enabled": true, "version": "v1" }, "fileCSIDriver": { "enabled": true }, "snapshotController": { "enabled": true } }, "oidcIssuerProfile": { "enabled": false }, "guardrailsProfile": { "level": "Warning", "version": "1.0" }, "workloadAutoScalerProfile": {} }, "identity": { "type": "SystemAssigned", "principalId": "0065de10-233b-431d-8de9-4bf5f4661944", "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" }, "sku": { "name": "Basic", "tier": "Free" } }



### Links
1. [Semantic and Model Violations Reference](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/Semantic-and-Model-Violations-Reference.md)
2. [S360 action item generator for Swagger issues](https://aka.ms/swaggers360)
ghost commented 1 year ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @qike-ms, @jwilder, @thomas1206, @seanmck.

Issue Details
## Microsoft.ContainerService/managedClusters@2022-09-02-preview - ROUNDTRIP_MISSING_PROPERTY ### Description I found differences between PUT request body and GET response: ```json { "properties": { "agentPoolProfiles": [ { "count": 1, "mode": "System", "name": "default", "vmSize": "Standard_D2_v2" } ], "dnsPrefix": "henglu1123aks", "guardrailsProfile": { "excludedNamespaces": [ is not returned from response "default" is not returned from response ] is not returned from response, "level": "Warning", "version": "1.0" } } } ``` ### Details 1. ARM Fully-Qualified Resource Type ``` Microsoft.ContainerService/managedClusters ``` 2. API Version ``` 2022-09-02-preview ``` 3. Swagger issue type ``` Swagger Correctness ``` 4. OperationId ``` TODO e.g., VirtualMachines_Get ``` 5. Swagger GitHub permalink ``` TODO, e.g., https://github.com/Azure/azure-rest-api-specs/blob/60723d13309c8f8060d020a7f3dd9d6e380f0bbd /specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json#L9065-L9101 ``` 6. Error code ``` ROUNDTRIP_MISSING_PROPERTY ``` 7. Request traces ``` PUT https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks?api-version=2022-09-02-preview Accept: application/json Authorization: REDACTED Content-Length: 287 Content-Type: application/json User-Agent: HashiCorp Terraform/1.2.8 (+https://www.terraform.io) Terraform Plugin SDK/2.8.0 terraform-provider-azapi/v1.1.0 pid-222c6c49-1b0a-5959-a213-6608f9eb8820 X-Ms-Correlation-Request-Id: REDACTED -------------------------------------------------------------------------------- {"identity":{"type":"SystemAssigned"},"location":"westeurope","properties":{"agentPoolProfiles":[{"count":1,"mode":"System","name":"default","vmSize":"Standard_D2_v2"}],"dnsPrefix":"henglu1123aks","guardrailsProfile":{"excludedNamespaces":["default"],"level":"Warning","version":"1.0"}}} -------------------------------------------------------------------------------- RESPONSE Status: 200 OK Azure-Asyncoperation: REDACTED Cache-Control: no-cache Content-Type: application/json Date: Mon, 12 Dec 2022 06:42:20 GMT Expires: -1 Pragma: no-cache Server: nginx Strict-Transport-Security: REDACTED Vary: REDACTED X-Content-Type-Options: REDACTED X-Ms-Correlation-Request-Id: REDACTED X-Ms-Ratelimit-Remaining-Subscription-Writes: REDACTED X-Ms-Request-Id: e1a64eda-80a0-4d35-8466-1a17d0031d04 X-Ms-Routing-Request-Id: REDACTED -------------------------------------------------------------------------------- { "id": "/subscriptions/{subscription_id}/resourcegroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks", "location": "westeurope", "name": "henglu1123aks", "type": "Microsoft.ContainerService/ManagedClusters", "properties": { "provisioningState": "Updating", "powerState": { "code": "Running" }, "kubernetesVersion": "1.23.12", "currentKubernetesVersion": "1.23.12", "dnsPrefix": "henglu1123aks", "fqdn": "henglu1123aks-7f5bb856.hcp.westeurope.azmk8s.io", "azurePortalFQDN": "henglu1123aks-7f5bb856.portal.hcp.westeurope.azmk8s.io", "agentPoolProfiles": [ { "name": "default", "count": 1, "vmSize": "Standard_D2_v2", "osDiskSizeGB": 128, "osDiskType": "Managed", "kubeletDiskType": "OS", "maxPods": 110, "type": "VirtualMachineScaleSets", "provisioningState": "Updating", "powerState": { "code": "Running" }, "orchestratorVersion": "1.23.12", "currentOrchestratorVersion": "1.23.12", "enableCustomCATrust": false, "mode": "System", "osType": "Linux", "osSKU": "Ubuntu", "nodeImageVersion": "AKSUbuntu-1804containerd-2022.11.02", "enableFIPS": false } ], "servicePrincipalProfile": { "clientId": "msi" }, "nodeResourceGroup": "MC_henglu1123aks_henglu1123aks_westeurope", "enableRBAC": true, "networkProfile": { "networkPlugin": "kubenet", "loadBalancerSku": "Standard", "loadBalancerProfile": { "managedOutboundIPs": { "count": 1 }, "effectiveOutboundIPs": [ { "id": "/subscriptions/{subscription_id}/resourceGroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.Network/publicIPAddresses/815c3edf-76ef-404a-8831-74ab22acff81" } ], "backendPoolType": "nodeIPConfiguration" }, "podCidr": "10.244.0.0/16", "serviceCidr": "10.0.0.0/16", "dnsServiceIP": "10.0.0.10", "dockerBridgeCidr": "172.17.0.1/16", "outboundType": "loadBalancer", "podCidrs": [ "10.244.0.0/16" ], "serviceCidrs": [ "10.0.0.0/16" ], "ipFamilies": [ "IPv4" ] }, "maxAgentPools": 100, "identityProfile": { "kubeletidentity": { "resourceId": "/subscriptions/{subscription_id}/resourcegroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.ManagedIdentity/userAssignedIdentities/henglu1123aks-agentpool", "clientId": "4792bfea-94be-4ee3-8a8b-3a708935370b", "objectId": "e90976bf-c820-453c-865c-dc8be5a681e3" } }, "securityProfile": {}, "storageProfile": { "diskCSIDriver": { "enabled": true, "version": "v1" }, "fileCSIDriver": { "enabled": true }, "snapshotController": { "enabled": true } }, "oidcIssuerProfile": { "enabled": false }, "guardrailsProfile": { "level": "Warning", "version": "1.0" }, "workloadAutoScalerProfile": {} }, "identity": { "type": "SystemAssigned", "principalId": "0065de10-233b-431d-8de9-4bf5f4661944", "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" }, "sku": { "name": "Basic", "tier": "Free" } } -------------------------------------------------------------------------------- GET https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks?api-version=2022-09-02-preview Accept: application/json Authorization: REDACTED User-Agent: HashiCorp Terraform/1.2.8 (+https://www.terraform.io) Terraform Plugin SDK/2.8.0 terraform-provider-azapi/v1.1.0 pid-222c6c49-1b0a-5959-a213-6608f9eb8820 X-Ms-Correlation-Request-Id: REDACTED -------------------------------------------------------------------------------- RESPONSE Status: 200 OK Cache-Control: no-cache Content-Type: application/json Date: Mon, 12 Dec 2022 06:43:52 GMT Expires: -1 Pragma: no-cache Server: nginx Strict-Transport-Security: REDACTED Vary: REDACTED X-Content-Type-Options: REDACTED X-Ms-Correlation-Request-Id: REDACTED X-Ms-Ratelimit-Remaining-Subscription-Reads: REDACTED X-Ms-Request-Id: 00177587-dba4-4c7d-b5f2-9d3dcb68775c X-Ms-Routing-Request-Id: REDACTED -------------------------------------------------------------------------------- { "id": "/subscriptions/{subscription_id}/resourcegroups/henglu1123aks/providers/Microsoft.ContainerService/managedClusters/henglu1123aks", "location": "westeurope", "name": "henglu1123aks", "type": "Microsoft.ContainerService/ManagedClusters", "properties": { "provisioningState": "Succeeded", "powerState": { "code": "Running" }, "kubernetesVersion": "1.23.12", "currentKubernetesVersion": "1.23.12", "dnsPrefix": "henglu1123aks", "fqdn": "henglu1123aks-7f5bb856.hcp.westeurope.azmk8s.io", "azurePortalFQDN": "henglu1123aks-7f5bb856.portal.hcp.westeurope.azmk8s.io", "agentPoolProfiles": [ { "name": "default", "count": 1, "vmSize": "Standard_D2_v2", "osDiskSizeGB": 128, "osDiskType": "Managed", "kubeletDiskType": "OS", "maxPods": 110, "type": "VirtualMachineScaleSets", "provisioningState": "Succeeded", "powerState": { "code": "Running" }, "orchestratorVersion": "1.23.12", "currentOrchestratorVersion": "1.23.12", "enableCustomCATrust": false, "mode": "System", "osType": "Linux", "osSKU": "Ubuntu", "nodeImageVersion": "AKSUbuntu-1804containerd-2022.11.02", "enableFIPS": false } ], "servicePrincipalProfile": { "clientId": "msi" }, "nodeResourceGroup": "MC_henglu1123aks_henglu1123aks_westeurope", "enableRBAC": true, "networkProfile": { "networkPlugin": "kubenet", "loadBalancerSku": "Standard", "loadBalancerProfile": { "managedOutboundIPs": { "count": 1 }, "effectiveOutboundIPs": [ { "id": "/subscriptions/{subscription_id}/resourceGroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.Network/publicIPAddresses/815c3edf-76ef-404a-8831-74ab22acff81" } ], "backendPoolType": "nodeIPConfiguration" }, "podCidr": "10.244.0.0/16", "serviceCidr": "10.0.0.0/16", "dnsServiceIP": "10.0.0.10", "dockerBridgeCidr": "172.17.0.1/16", "outboundType": "loadBalancer", "podCidrs": [ "10.244.0.0/16" ], "serviceCidrs": [ "10.0.0.0/16" ], "ipFamilies": [ "IPv4" ] }, "maxAgentPools": 100, "identityProfile": { "kubeletidentity": { "resourceId": "/subscriptions/{subscription_id}/resourcegroups/MC_henglu1123aks_henglu1123aks_westeurope/providers/Microsoft.ManagedIdentity/userAssignedIdentities/henglu1123aks-agentpool", "clientId": "4792bfea-94be-4ee3-8a8b-3a708935370b", "objectId": "e90976bf-c820-453c-865c-dc8be5a681e3" } }, "securityProfile": {}, "storageProfile": { "diskCSIDriver": { "enabled": true, "version": "v1" }, "fileCSIDriver": { "enabled": true }, "snapshotController": { "enabled": true } }, "oidcIssuerProfile": { "enabled": false }, "guardrailsProfile": { "level": "Warning", "version": "1.0" }, "workloadAutoScalerProfile": {} }, "identity": { "type": "SystemAssigned", "principalId": "0065de10-233b-431d-8de9-4bf5f4661944", "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" }, "sku": { "name": "Basic", "tier": "Free" } } -------------------------------------------------------------------------------- ``` ### Links 1. [Semantic and Model Violations Reference](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/Semantic-and-Model-Violations-Reference.md) 2. [S360 action item generator for Swagger issues](https://aka.ms/swaggers360)
Author: ms-henglu
Assignees: -
Labels: `Service Attention`, `needs-triage`, `Container Service`
Milestone: -