feat(apim): Introduce gateway resource (#27757)

* WIP * Update sample * WIP * Add GatewayNameParameter * Clean up * Update sample * Add another sample * Add sample for delete gateway * Remove endpoints * Fix typo * Add list sample * Clean up Signed-off-by: Tom Kerkhove <[email protected]> * Add disclaimer Signed-off-by: Tom Kerkhove <[email protected]> * Make it pretty 💄 Signed-off-by: Tom Kerkhove <[email protected]> * Refer to new file Signed-off-by: Tom Kerkhove <[email protected]> * Add missing ApiManagementGatewayListResult Signed-off-by: Tom Kerkhove <[email protected]> * Update sample reference Signed-off-by: Tom Kerkhove <[email protected]> * Remove ApiManagementGatewayIdentity + List by operation Signed-off-by: Tom Kerkhove <[email protected]> * Add more sample Signed-off-by: Tom Kerkhove <[email protected]> * Latest version of common types Signed-off-by: Tom Kerkhove <[email protected]> * Remove 200 for delete Signed-off-by: Tom Kerkhove <[email protected]> * Formatting and re-order Signed-off-by: Tom Kerkhove <[email protected]> * Align with spec Signed-off-by: Tom Kerkhove <[email protected]> * Align sample with spec Signed-off-by: Tom Kerkhove <[email protected]> * Error response from common types Signed-off-by: Tom Kerkhove <[email protected]> * Rename SKU name * Have seperate SKU for patch to not make it mandatory * Remove empty required * Improve note * Rename schema * Remove unused type * sku.capacity should not be required --------- Signed-off-by: Tom Kerkhove <[email protected]>
Azure · rkmanda · Jun 5, 2024 · Jan 3, 2024 · Jan 3, 2024 · Jan 3, 2024
commit 6a9393481844e8b7a1638f414c8f4c821515810b
@@ -357,6 +357,17 @@
       "description": "Email identifier.",
       "x-ms-parameter-location": "method"
     },
+    "GatewayNameParameter": {
+      "name": "gatewayName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the API Management gateway.",
+      "minLength": 1,
+      "maxLength": 50,
+      "pattern": "^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$",
+      "x-ms-parameter-location": "method"
+    },
     "GroupIdParameter": {
       "name": "groupId",
       "in": "path",

@@ -0,0 +1,106 @@
+{
+  "parameters": {
+    "gatewayName": "apimGateway1",
+    "resourceGroupName": "rg1",
+    "api-version": "2023-09-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "parameters": {
+      "properties": {
+        "backend": {
+          "subnet": {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+          }
+        }
+      },
+      "sku": {
+        "name": "Standard",
+        "capacity": 1
+      },
+      "location": "South Central US",
+      "tags": {
+        "Name": "Contoso",
+        "Test": "User"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/apimGateway1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2023-09-01-preview&asyncResponse",
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/apimGateway1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2023-09-01-preview&asyncResponse"
+      },
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/apimGateway1",
+        "name": "apimGateway1",
+        "type": "Microsoft.ApiManagement/gateway",
+        "tags": {
+          "api-version": "2023-09-01-preview"
+        },
+        "location": "East US",
+        "etag": "AAAAAAAmRAM=",
+        "properties": {
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2022-07-11T18:41:01.2506031Z",
+          "backend": {
+            "subnet": {
+              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+            }
+          }
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        },
+        "systemData": {
+          "createdBy": "[email protected]",
+          "createdByType": "User",
+          "createdAt": "2022-07-11T18:41:00.9390609Z",
+          "lastModifiedBy": "[email protected]",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-07-11T18:41:00.9390609Z"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/apimGateway1",
+        "name": "apimGateway1",
+        "type": "Microsoft.ApiManagement/gateways",
+        "tags": {
+          "api-version": "2023-09-01-preview"
+        },
+        "location": "East US",
+        "etag": "AAAAAAAmREI=",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2022-07-11T18:41:01.2506031Z",
+          "frontend": {
+            "defaultHostname": "apimGateway1.eastus.gateway.azure-api.net"
+          },
+          "backend": {
+            "subnet": {
+              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+            }
+          },
+          "configurationApi": {
+            "hostname": "apimGateway1.eastus.configuration.gateway.azure-api.net"
+          }
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        },
+        "systemData": {
+          "createdBy": "[email protected]",
+          "createdByType": "User",
+          "createdAt": "2022-07-11T18:41:00.9390609Z",
+          "lastModifiedBy": "[email protected]",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-07-11T18:41:00.9390609Z"
+        }
+      }
+    }
+  }
+}
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "gatewayName": "example-gateway",
+    "resourceGroupName": "rg1",
+    "api-version": "2023-09-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateway/example-gateway/operationresults/TGV2eTExMDZtMDJfVGVybV9jMmZlY2QwMA==?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateway/example-gateway",
+        "name": "example-gateway",
+        "type": "Microsoft.ApiManagement/gateway",
+        "tags": {},
+        "location": "West US",
+        "etag": "AAAAAAFfhHY=",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "Deleting",
+          "createdAtUtc": "2016-12-20T19:41:21.5823069Z",
+          "frontend": {
+            "defaultHostname": "example-gateway.westus.gateway.azure-api.net"
+          },
+          "backend": {
+            "subnet": {
+              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+            }
+          },
+          "configurationApi": {
+            "hostname": "example-gateway.westus.configuration.gateway.azure-api.net"
+          }
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        }
+      }
+    },
+    "204": {}
+  }
+}
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "gatewayName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2023-09-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateway/example-gateway",
+        "name": "example-gateway",
+        "type": "Microsoft.ApiManagement/gateway",
+        "tags": {
+          "owner": "v-aswmoh",
+          "ReleaseName": "Z3"
+        },
+        "location": "East US",
+        "etag": "AAAAAAAWN/4=",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
+          "frontend": {
+            "defaultHostname": "example-gateway.eastus.gateway.azure-api.net"
+          },
+          "backend": {
+            "subnet": {
+              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+            }
+          },
+          "configurationApi": {
+            "hostname": "example-gateway.eastus.configuration.gateway.azure-api.net"
+          }
+        },
+        "sku": {
+          "name": "Standard",
+          "capacity": 1
+        },
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "User",
+          "createdAt": "2021-06-16T09:40:00.7106733Z",
+          "lastModifiedBy": "[email protected]",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
+        }
+      }
+    }
+  }
+}
@@ -0,0 +1,83 @@
+{
+  "parameters": {
+    "api-version": "2023-09-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/standard-gw-1",
+            "name": "standard-gw-1",
+            "type": "Microsoft.ApiManagement/gateways",
+            "tags": {
+              "owner": "v-aswmoh",
+              "ReleaseName": "Z3"
+            },
+            "location": "West US",
+            "etag": "AAAAAAAWN/4=",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
+              "frontend": {
+                "defaultHostname": "standard-gw-1.westus.gateway.azure-api.net"
+              },
+              "backend": {
+                "subnet": {
+                  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+                }
+              },
+              "configurationApi": {
+                "hostname": "standard-gw-1.westus.configuration.gateway.azure-api.net"
+              }
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            },
+            "systemData": {
+              "createdBy": "[email protected]",
+              "createdByType": "User",
+              "createdAt": "2021-06-16T09:40:00.7106733Z",
+              "lastModifiedBy": "[email protected]",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.ApiManagement/gateways/standard-gw-2",
+            "name": "standard-gw-2",
+            "type": "Microsoft.ApiManagement/gateways",
+            "tags": {
+              "Owner": "vitaliik"
+            },
+            "location": "East US",
+            "etag": "AAAAAAAWKwo=",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
+              "frontend": {
+                "defaultHostname": "standard-gw-2.eastus.gateway.azure-api.net"
+              },
+              "backend": {
+                "subnet": {
+                  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn2/subnets/sn2"
+                }
+              },
+              "configurationApi": {
+                "hostname": "standard-gw-2.eastus.configuration.gateway.azure-api.net"
+              }
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
@@ -0,0 +1,84 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "api-version": "2023-09-01-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/standard-gw-1",
+            "name": "standard-gw-1",
+            "type": "Microsoft.ApiManagement/gateways",
+            "tags": {
+              "owner": "v-aswmoh",
+              "ReleaseName": "Z3"
+            },
+            "location": "West US",
+            "etag": "AAAAAAAWN/4=",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
+              "frontend": {
+                "defaultHostname": "standard-gw-1.westus.gateway.azure-api.net"
+              },
+              "backend": {
+                "subnet": {
+                  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn1/subnets/sn1"
+                }
+              },
+              "configurationApi": {
+                "hostname": "standard-gw-1.westus.configuration.gateway.azure-api.net"
+              }
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            },
+            "systemData": {
+              "createdBy": "[email protected]",
+              "createdByType": "User",
+              "createdAt": "2021-06-16T09:40:00.7106733Z",
+              "lastModifiedBy": "[email protected]",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/gateways/standard-gw-2",
+            "name": "standard-gw-2",
+            "type": "Microsoft.ApiManagement/gateways",
+            "tags": {
+              "Owner": "vitaliik"
+            },
+            "location": "East US",
+            "etag": "AAAAAAAWKwo=",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "targetProvisioningState": "",
+              "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
+              "frontend": {
+                "defaultHostname": "standard-gw-2.eastus.gateway.azure-api.net"
+              },
+              "backend": {
+                "subnet": {
+                  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vn2/subnets/sn2"
+                }
+              },
+              "configurationApi": {
+                "hostname": "standard-gw-2.eastus.configuration.gateway.azure-api.net"
+              }
+            },
+            "sku": {
+              "name": "Standard",
+              "capacity": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}