Api Management Service - Get
Pobiera opis zasobu usługi API Management.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}?api-version=2022-08-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
service
|
path | True |
string |
Nazwa usługi API Management. Regex pattern: |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślnie uzyskaliśmy zasób usługi API Management. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Api |
Api |
Api |
ApiManagementServiceGetMultiRegionInternalVnet
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimservice1",
"name": "apimservice1",
"type": "Microsoft.ApiManagement/service",
"tags": {},
"location": "West US",
"etag": "AAAAAADqC0c=",
"properties": {
"publisherEmail": "abcs@contoso.com",
"publisherName": "contoso publisher",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2019-12-02T01:42:09.1268424Z",
"gatewayUrl": "https://apimservice1.azure-api.net",
"gatewayRegionalUrl": "https://apimservice1-westus-01.regional.azure-api.net",
"portalUrl": "https://apimservice1.portal.azure-api.net",
"developerPortalUrl": "https://apimService1.developer.azure-api.net",
"managementApiUrl": "https://apimservice1.management.azure-api.net",
"scmUrl": "https://apimservice1.scm.azure-api.net",
"hostnameConfigurations": [
{
"type": "Proxy",
"hostName": "apimService1.azure-api.net",
"negotiateClientCertificate": false,
"defaultSslBinding": false,
"certificateSource": "BuiltIn"
},
{
"type": "Proxy",
"hostName": "apimgatewaytest.preview.net",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2019-08-16T16:51:34+00:00",
"thumbprint": "B4330123DBAXXXXXXXXX1F35E84493476",
"subject": "CN=*.preview.net"
},
"defaultSslBinding": true,
"certificateSource": "Custom"
}
],
"publicIPAddresses": [
"137.XXX.11.74"
],
"privateIPAddresses": [
"172.XX.0.5"
],
"additionalLocations": [
{
"location": "West US 2",
"sku": {
"name": "Premium",
"capacity": 1
},
"publicIPAddresses": [
"40.XXX.79.187"
],
"privateIPAddresses": [
"10.0.X.6"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/APIMVNet/subnets/apim-internal-sub"
},
"gatewayRegionalUrl": "https://apimservice1-westus2-01.regional.azure-api.net",
"disableGateway": false
}
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apim-appGateway-vnet/subnets/apim-subnet"
},
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False"
},
"virtualNetworkType": "Internal",
"disableGateway": false,
"apiVersionConstraint": {}
},
"sku": {
"name": "Premium",
"capacity": 1
}
}
ApiManagementServiceGetService
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/OGF-Z3-06162021-Premium",
"name": "OGF-Z3-06162021-Premium",
"type": "Microsoft.ApiManagement/service",
"tags": {
"owner": "v-aswmoh",
"ReleaseName": "Z3"
},
"location": "East US",
"etag": "AAAAAAAWN/4=",
"properties": {
"publisherEmail": "string",
"publisherName": "Test Premium",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2021-06-16T09:40:00.9453556Z",
"gatewayUrl": "https://ogf-z3-06162021-premium.azure-api.net",
"gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus-01.regional.azure-api.net",
"portalUrl": "https://ogf-z3-06162021-premium.portal.azure-api.net",
"developerPortalUrl": "https://ogf-z3-06162021-premium.developer.azure-api.net",
"managementApiUrl": "https://ogf-z3-06162021-premium.management.azure-api.net",
"scmUrl": "https://ogf-z3-06162021-premium.scm.azure-api.net",
"hostnameConfigurations": [
{
"type": "Proxy",
"hostName": "ogf-z3-06162021-premium.azure-api.net",
"negotiateClientCertificate": false,
"defaultSslBinding": false,
"certificateSource": "BuiltIn"
},
{
"type": "Proxy",
"hostName": "gateway.current.int-azure-api.net",
"keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
"negotiateClientCertificate": true,
"certificate": {
"expiry": "2022-01-08T22:32:32+00:00",
"thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
"subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
},
"defaultSslBinding": true,
"certificateSource": "Custom"
},
{
"type": "DeveloperPortal",
"hostName": "developer.current.int-azure-api.net",
"keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2022-01-08T22:32:32+00:00",
"thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
"subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
},
"defaultSslBinding": false,
"certificateSource": "Custom"
},
{
"type": "Management",
"hostName": "mgmt.current.int-azure-api.net",
"keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2022-01-08T22:32:32+00:00",
"thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
"subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
},
"defaultSslBinding": false,
"certificateSource": "Custom"
}
],
"publicIPAddresses": [
"13.92.130.49"
],
"additionalLocations": [
{
"location": "East US 2",
"sku": {
"name": "Premium",
"capacity": 1
},
"zones": [],
"publicIPAddresses": [
"40.70.24.106"
],
"gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus2-01.regional.azure-api.net",
"disableGateway": false,
"platformVersion": "stv2"
}
],
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false"
},
"virtualNetworkType": "None",
"certificates": [],
"disableGateway": false,
"apiVersionConstraint": {
"minApiVersion": "2019-12-01"
},
"publicNetworkAccess": "Enabled",
"privateEndpointConnections": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/privateEndpointConnections/privateEndpointProxyName",
"type": "Microsoft.ApiManagement/service/privateEndpointConnections",
"name": "privateEndpointProxyName",
"properties": {
"provisioningState": "Pending",
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
},
"privateLinkServiceConnectionState": {
"status": "Pending",
"description": "Please approve my request, thanks",
"actionsRequired": "None"
},
"groupIds": [
"Gateway"
]
}
}
],
"platformVersion": "stv2"
},
"sku": {
"name": "Premium",
"capacity": 1
},
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "306205e7-b21a-41bf-92e2-3e28af30041e",
"tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
"userAssignedIdentities": {
"/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ogf-identity": {
"principalId": "713784d2-ee37-412a-95f0-3768f397f82d",
"clientId": "8d9791f2-0cdf-41f4-9e66-cdc39b496789"
}
}
},
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2021-06-16T09:40:00.7106733Z",
"lastModifiedBy": "foo@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
}
}
ApiManagementServiceGetServiceHavingMsi
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"tags": {},
"location": "West Europe",
"etag": "AAAAAAAENfI=",
"properties": {
"publisherEmail": "foo@contoso.com",
"publisherName": "Contoso",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2016-04-12T00:20:15.6018952Z",
"gatewayUrl": "https://apimService1.azure-api.net",
"gatewayRegionalUrl": "https://apimService1-westeurope-01.regional.azure-api.net",
"portalUrl": "https://apimService1.portal.azure-api.net",
"developerPortalUrl": "https://apimService1.developer.azure-api.net",
"managementApiUrl": "https://apimService1.management.azure-api.net",
"scmUrl": "https://apimService1.scm.azure-api.net",
"hostnameConfigurations": [
{
"type": "Proxy",
"hostName": "apimService1.azure-api.net",
"negotiateClientCertificate": false,
"defaultSslBinding": false,
"certificateSource": "BuiltIn"
},
{
"type": "Proxy",
"hostName": "proxy.msitesting.net",
"keyVaultId": "https://samir-msi-keyvault.vault.azure.net/secrets/msicertificate",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2020-12-18T11:11:47+00:00",
"thumbprint": "9833D531D7A45XXXXXA85908BD3692E0BD3F",
"subject": "CN=*.msitesting.net"
},
"defaultSslBinding": true,
"certificateSource": "KeyVault"
}
],
"publicIPAddresses": [
"13.94.xxx.188"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
},
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
},
"virtualNetworkType": "External",
"disableGateway": false
},
"sku": {
"name": "Premium",
"capacity": 1
},
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "ca1d33f7-0000-42ec-0000-d526a1ee953a",
"tenantId": "72f988bf-0000-41af-0000-2d7cd011db47",
"userAssignedIdentities": {
"/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {
"principalId": "95194df2-9208-0000-0000-a10d2af9b5a3",
"clientId": "aaff9c7d-0000-4db2-0000-ab0e3e7806cf"
}
}
}
}
Definicje
Nazwa | Opis |
---|---|
Additional |
Opis dodatkowej lokalizacji zasobu API Management. |
Api |
Właściwości tożsamości zasobu usługi Api Management. |
Api |
Pojedynczy zasób usługi API Management w obszarze Lista lub Uzyskiwanie odpowiedzi. |
Api |
API Management właściwości jednostki SKU zasobu usługi. |
Apim |
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. |
Api |
Ograniczenie wersji interfejsu API płaszczyzny sterowania dla usługi API Management. |
Arm |
Otoka dla identyfikatora zasobu usługi ARM |
Certificate |
Konfiguracja certyfikatu składająca się z niezauwierzonych pośrednich i certyfikatów głównych. |
Certificate |
Informacje o certyfikacie SSL. |
Certificate |
Źródło certyfikatu. |
Certificate |
Stan certyfikatu. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Błąd Kontrakt pola. |
Error |
Odpowiedź na błąd. |
Hostname |
Niestandardowa konfiguracja nazwy hosta. |
Hostname |
Typ nazwy hosta. |
Nat |
Właściwość może służyć do włączania bramy translatora adresów sieciowych dla tej usługi API Management. |
Platform |
Wersja platformy obliczeniowej z uruchomioną usługą. |
Private |
Stan połączenia prywatnego punktu końcowego. |
Private |
Kolekcja informacji o stanie połączenia między konsumentem usługi a dostawcą. |
Public |
Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej usługi API Management. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są metodą wyłącznego dostępu. Wartość domyślna to "Włączone" |
Remote |
Zasób połączenia z zdalnym prywatnym punktem końcowym. |
Sku |
Nazwa jednostki SKU. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
User |
|
Virtual |
Konfiguracja sieci wirtualnej, w której wdrożono usługę API Management. |
Virtual |
Typ sieci VPN, w której należy skonfigurować usługę API Management. Brak (wartość domyślna) oznacza, że usługa API Management nie jest częścią żadnego Virtual Network, zewnętrzne oznacza, że wdrożenie API Management jest skonfigurowane wewnątrz Virtual Network mającego punkt końcowy dostępny z Internetu, a wewnętrzny oznacza, że API Management wdrożenie jest konfigurowane wewnątrz Virtual Network tylko z punktem końcowym dostępnym w intranecie. |
AdditionalLocation
Opis dodatkowej lokalizacji zasobu API Management.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
disableGateway |
boolean |
False |
Właściwość jest prawidłowa tylko dla usługi Api Management wdrożonej w wielu lokalizacjach. Może to służyć do wyłączania bramy w tej dodatkowej lokalizacji. |
gatewayRegionalUrl |
string |
Adres URL bramy usługi API Management w regionie. |
|
location |
string |
Nazwa lokalizacji dodatkowego regionu między regionami centrum danych platformy Azure. |
|
natGatewayState | Disabled |
Właściwość może służyć do włączania bramy translatora adresów sieciowych dla tej usługi API Management. |
|
outboundPublicIPAddresses |
string[] |
Prefiksy publicznych adresów IPV4 dla ruchu wychodzącego skojarzone z wdrożonym usługą bramy translatora adresów sieciowych. Dostępne tylko dla jednostki SKU Premium na platformie stv2. |
|
platformVersion |
Wersja platformy obliczeniowej z uruchomioną usługą. |
||
privateIPAddresses |
string[] |
Prywatne statyczne adresy IP usługi API Management wdrożonej w wewnętrznej Virtual Network w określonej dodatkowej lokalizacji. Dostępne tylko dla jednostek SKU w warstwie Podstawowa, Standardowa, Premium i Izolowana. |
|
publicIPAddresses |
string[] |
Publiczne statyczne adresy IP usługi API Management w dodatkowej lokalizacji. Dostępne tylko dla jednostek SKU w warstwie Podstawowa, Standardowa, Premium i Izolowana. |
|
publicIpAddressId |
string |
Publiczny adres IP jednostki SKU w wersji 4, który ma być skojarzony z usługą wdrożona Virtual Network w lokalizacji. Obsługiwane tylko w przypadku jednostki SKU w warstwie Premium wdrażanej w Virtual Network. |
|
sku |
Właściwości jednostki SKU usługi API Management. |
||
virtualNetworkConfiguration |
Konfiguracja sieci wirtualnej dla lokalizacji. |
||
zones |
string[] |
Lista stref dostępności oznaczających miejsce, z którego ma pochodzić zasób. |
ApiManagementServiceIdentity
Właściwości tożsamości zasobu usługi Api Management.
Nazwa | Typ | Opis |
---|---|---|
principalId |
string |
Identyfikator podmiotu zabezpieczeń tożsamości. |
tenantId |
string |
Identyfikator dzierżawy klienta tożsamości. |
type |
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. |
|
userAssignedIdentities |
<string,
User |
Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ApiManagementServiceResource
Pojedynczy zasób usługi API Management w obszarze Lista lub Uzyskiwanie odpowiedzi.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
etag |
string |
Element ETag zasobu. |
|
id |
string |
Identyfikator zasobu. |
|
identity |
Tożsamość usługi zarządzanej usługi Api Management. |
||
location |
string |
Lokalizacja zasobu. |
|
name |
string |
Nazwa zasobu. |
|
properties.additionalLocations |
Dodatkowe lokalizacje centrum danych usługi API Management. |
||
properties.apiVersionConstraint |
Ograniczenie wersji interfejsu API płaszczyzny sterowania dla usługi API Management. |
||
properties.certificates |
Lista certyfikatów, które należy zainstalować w usłudze API Management. Maksymalna obsługiwana liczba certyfikatów, które można zainstalować, wynosi 10. |
||
properties.createdAtUtc |
string |
Data utworzenia czasu UTC usługi API Management. Data jest zgodna z następującym formatem: |
|
properties.customProperties |
object |
Właściwości niestandardowe usługi API Management. |
|
properties.developerPortalUrl |
string |
Adres URL punktu końcowego portalu DEveloper usługi API Management. |
|
properties.disableGateway |
boolean |
False |
Właściwość jest prawidłowa tylko dla usługi Api Management wdrożonej w wielu lokalizacjach. Może to służyć do wyłączania bramy w regionie głównym. |
properties.enableClientCertificate |
boolean |
False |
Właściwość przeznaczona tylko do użycia w przypadku usługi SKU Zużycie. Wymusza to prezentowanie certyfikatu klienta dla każdego żądania do bramy. Umożliwia to również uwierzytelnianie certyfikatu w zasadach w bramie. |
properties.gatewayRegionalUrl |
string |
Adres URL bramy usługi API Management w regionie domyślnym. |
|
properties.gatewayUrl |
string |
Adres URL bramy usługi API Management. |
|
properties.hostnameConfigurations |
Niestandardowa konfiguracja nazwy hosta usługi API Management. |
||
properties.managementApiUrl |
string |
Adres URL punktu końcowego interfejsu API zarządzania usługi API Management. |
|
properties.natGatewayState | Disabled |
Właściwość może służyć do włączania bramy translatora adresów sieciowych dla tej usługi API Management. |
|
properties.notificationSenderEmail |
string |
Email adres, z którego zostanie wysłane powiadomienie. |
|
properties.outboundPublicIPAddresses |
string[] |
Prefiksy publicznych adresów IPV4 dla ruchu wychodzącego skojarzone z wdrożonym usługą bramy translatora adresów sieciowych. Dostępne tylko dla jednostki SKU Premium na platformie stv2. |
|
properties.platformVersion |
Wersja platformy obliczeniowej z uruchomioną usługą w tej lokalizacji. |
||
properties.portalUrl |
string |
Adres URL punktu końcowego portalu wydawcy usługi API Management. |
|
properties.privateEndpointConnections |
Lista połączeń prywatnego punktu końcowego tej usługi. |
||
properties.privateIPAddresses |
string[] |
Prywatne statyczne adresy IP usługi API Management w regionie podstawowym, które są wdrażane w wewnętrznej Virtual Network. Dostępne tylko dla jednostek SKU w warstwie Podstawowa, Standardowa, Premium i Izolowana. |
|
properties.provisioningState |
string |
Bieżący stan aprowizacji usługi API Management, która może być jedną z następujących wartości: Utworzono/Aktywowanie/Powodzenie/Aktualizowanie/Niepowodzenie/Zatrzymano/Zakończenie/ZakończenieFailed/Deleted. |
|
properties.publicIPAddresses |
string[] |
Publiczne statyczne adresy IP usługi API Management w regionie podstawowym. Dostępne tylko dla jednostek SKU w warstwie Podstawowa, Standardowa, Premium i Izolowana. |
|
properties.publicIpAddressId |
string |
Publiczny adres IP jednostki SKU w wersji 4, który ma być skojarzony z usługą wdrożona Virtual Network w regionie. Obsługiwane tylko w przypadku jednostek SKU developer i Premium wdrażanych w Virtual Network. |
|
properties.publicNetworkAccess |
Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej usługi API Management. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są metodą wyłącznego dostępu. Wartość domyślna to "Włączone" |
||
properties.publisherEmail |
string |
Adres e-mail wydawcy. |
|
properties.publisherName |
string |
Nazwa wydawcy. |
|
properties.restore |
boolean |
False |
Cofanie usuwania usługi Api Management, jeśli została wcześniej usunięta nietrwale. Jeśli ta flaga jest określona i ustawiona na True, wszystkie inne właściwości zostaną zignorowane. |
properties.scmUrl |
string |
Adres URL punktu końcowego SCM usługi API Management. |
|
properties.targetProvisioningState |
string |
Stan aprowizacji usługi API Management, która jest objęta długotrwałą operacją uruchomioną w usłudze. |
|
properties.virtualNetworkConfiguration |
Konfiguracja sieci wirtualnej usługi API Management. |
||
properties.virtualNetworkType | None |
Typ sieci VPN, w której należy skonfigurować usługę API Management. Brak (wartość domyślna) oznacza, że usługa API Management nie jest częścią żadnego Virtual Network, zewnętrzne oznacza, że wdrożenie API Management jest skonfigurowane wewnątrz Virtual Network mającego punkt końcowy dostępny z Internetu, a wewnętrzny oznacza, że API Management wdrożenie jest konfigurowane wewnątrz Virtual Network tylko z punktem końcowym dostępnym w intranecie. |
|
sku |
Właściwości jednostki SKU usługi API Management. |
||
systemData |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
||
tags |
object |
Tagi zasobów. |
|
type |
string |
Typ zasobu API Management jest ustawiony na Wartość Microsoft.ApiManagement. |
|
zones |
string[] |
Lista stref dostępności oznaczających miejsce, z którego ma pochodzić zasób. |
ApiManagementServiceSkuProperties
API Management właściwości jednostki SKU zasobu usługi.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Pojemność jednostki SKU (liczba wdrożonych jednostek SKU). W przypadku pojemności jednostki SKU zużycie należy określić wartość 0. |
name |
Nazwa jednostki SKU. |
ApimIdentityType
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
ApiVersionConstraint
Ograniczenie wersji interfejsu API płaszczyzny sterowania dla usługi API Management.
Nazwa | Typ | Opis |
---|---|---|
minApiVersion |
string |
Ogranicz wywołania interfejsu API płaszczyzny sterowania do usługi API Management o wersji równej lub nowszej niż ta wartość. |
ArmIdWrapper
Otoka dla identyfikatora zasobu usługi ARM
Nazwa | Typ | Opis |
---|---|---|
id |
string |
CertificateConfiguration
Konfiguracja certyfikatu składająca się z niezauwierzonych pośrednich i certyfikatów głównych.
Nazwa | Typ | Opis |
---|---|---|
certificate |
Informacje o certyfikacie. |
|
certificatePassword |
string |
Hasło certyfikatu. |
encodedCertificate |
string |
Certyfikat zakodowany w formacie Base64. |
storeName |
enum:
|
Lokalizacja magazynu certyfikatów System.Security.Cryptography.x509certificates.StoreName. Prawidłowe lokalizacje to tylko katalog główny i certyfikatu. |
CertificateInformation
Informacje o certyfikacie SSL.
Nazwa | Typ | Opis |
---|---|---|
expiry |
string |
Data wygaśnięcia certyfikatu. Data jest zgodna z następującym formatem: |
subject |
string |
Podmiot certyfikatu. |
thumbprint |
string |
Odcisk palca certyfikatu. |
CertificateSource
Źródło certyfikatu.
Nazwa | Typ | Opis |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
KeyVault |
string |
|
Managed |
string |
CertificateStatus
Stan certyfikatu.
Nazwa | Typ | Opis |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorFieldContract
Błąd Kontrakt pola.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu poziomu właściwości. |
message |
string |
Czytelna dla człowieka reprezentacja błędu na poziomie właściwości. |
target |
string |
Nazwa właściwości. |
ErrorResponse
Odpowiedź na błąd.
Nazwa | Typ | Opis |
---|---|---|
error.code |
string |
Kod błędu zdefiniowany przez usługę. Ten kod służy jako podstan kodu błędu HTTP określonego w odpowiedzi. |
error.details |
Lista nieprawidłowych pól jest wysyłana w żądaniu w przypadku błędu walidacji. |
|
error.message |
string |
Czytelna dla człowieka reprezentacja błędu. |
HostnameConfiguration
Niestandardowa konfiguracja nazwy hosta.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
certificate |
Informacje o certyfikacie. |
||
certificatePassword |
string |
Hasło certyfikatu. |
|
certificateSource |
Źródło certyfikatu. |
||
certificateStatus |
Stan certyfikatu. |
||
defaultSslBinding |
boolean |
False |
Określ wartość true, aby skonfigurować certyfikat skojarzony z tą nazwą hosta jako domyślny certyfikat SSL. Jeśli klient nie wysyła nagłówka SNI, będzie to certyfikat, który zostanie zakwestionowany. Właściwość jest przydatna, jeśli usługa ma włączoną wiele niestandardowych nazw hostów i musi zdecydować o domyślnym certyfikacie SSL. Ustawienie stosowane tylko do typu nazwy hosta bramy. |
encodedCertificate |
string |
Certyfikat zakodowany w formacie Base64. |
|
hostName |
string |
Nazwa hosta do skonfigurowania w usłudze Api Management. |
|
identityClientId |
string |
Identyfikator clientId przypisanej przez system lub użytkownika tożsamości zarządzanej wygenerowany przez Azure AD, który ma dostęp GET do magazynu kluczy zawierającego certyfikat SSL. |
|
keyVaultId |
string |
Adres URL wpisu tajnego usługi KeyVault zawierającego certyfikat SSL. Jeśli podano bezwzględny adres URL zawierający wersję, automatyczna aktualizacja certyfikatu SSL nie będzie działać. Wymaga to skonfigurowania usługi Api Management przy użyciu aka.ms/apimmsi. Wpis tajny powinien być typu application/x-pkcs12 |
|
negotiateClientCertificate |
boolean |
False |
Określ wartość true, aby zawsze negocjować certyfikat klienta na nazwie hosta. Wartość domyślna to false. |
type |
Typ nazwy hosta. |
HostnameType
Typ nazwy hosta.
Nazwa | Typ | Opis |
---|---|---|
DeveloperPortal |
string |
|
Management |
string |
|
Portal |
string |
|
Proxy |
string |
|
Scm |
string |
NatGatewayState
Właściwość może służyć do włączania bramy translatora adresów sieciowych dla tej usługi API Management.
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
Brama translatora adresów sieciowych jest wyłączona dla usługi. |
Enabled |
string |
Brama translatora adresów sieciowych jest włączona dla usługi. |
PlatformVersion
Wersja platformy obliczeniowej z uruchomioną usługą.
Nazwa | Typ | Opis |
---|---|---|
mtv1 |
string |
Platforma z uruchomioną usługą na platformie Multi Tenant V1. |
stv1 |
string |
Platforma z uruchomioną usługą na platformie Single Tenant V1. |
stv2 |
string |
Platforma z uruchomioną usługą na platformie Single Tenant V2. |
undetermined |
string |
Nie można określić wersji platformy, ponieważ platforma obliczeniowa nie jest wdrożona. |
PrivateEndpointServiceConnectionStatus
Stan połączenia prywatnego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Kolekcja informacji o stanie połączenia między konsumentem usługi a dostawcą.
Nazwa | Typ | Opis |
---|---|---|
actionsRequired |
string |
Komunikat wskazujący, czy zmiany dostawcy usług wymagają aktualizacji u konsumenta. |
description |
string |
Przyczyna zatwierdzenia/odrzucenia połączenia. |
status |
Wskazuje, czy połączenie zostało zatwierdzone/odrzucone/usunięte przez właściciela usługi. |
PublicNetworkAccess
Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej usługi API Management. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są metodą wyłącznego dostępu. Wartość domyślna to "Włączone"
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RemotePrivateEndpointConnectionWrapper
Zasób połączenia z zdalnym prywatnym punktem końcowym.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu połączenia z prywatnym punktem końcowym |
name |
string |
Nazwa połączenia prywatnego punktu końcowego |
properties.groupIds |
string[] |
Wszystkie identyfikatory grup. |
properties.privateEndpoint |
Zasób prywatnego punktu końcowego. |
|
properties.privateLinkServiceConnectionState |
Kolekcja informacji o stanie połączenia między konsumentem usługi a dostawcą. |
|
properties.provisioningState |
string |
Stan aprowizacji zasobu połączenia prywatnego punktu końcowego. |
type |
string |
Typ zasobu połączenia prywatnego punktu końcowego |
SkuType
Nazwa jednostki SKU.
Nazwa | Typ | Opis |
---|---|---|
Basic |
string |
Podstawowa jednostka SKU usługi Api Management. |
Consumption |
string |
Jednostka SKU użycia usługi Api Management. |
Developer |
string |
Jednostka SKU dewelopera usługi Api Management. |
Isolated |
string |
Izolowana jednostka SKU usługi Api Management. |
Premium |
string |
Jednostka SKU w warstwie Premium usługi Api Management. |
Standard |
string |
Standardowa jednostka SKU usługi Api Management. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobów (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserIdentityProperties
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta tożsamości przypisanej przez użytkownika. |
principalId |
string |
Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. |
VirtualNetworkConfiguration
Konfiguracja sieci wirtualnej, w której wdrożono usługę API Management.
Nazwa | Typ | Opis |
---|---|---|
subnetResourceId |
string |
Pełny identyfikator zasobu podsieci w sieci wirtualnej w celu wdrożenia usługi API Management. |
subnetname |
string |
Nazwa podsieci. |
vnetid |
string |
Identyfikator sieci wirtualnej. Jest to zazwyczaj identyfikator GUID. Domyślnie oczekiwano identyfikatora GUID o wartości null. |
VirtualNetworkType
Typ sieci VPN, w której należy skonfigurować usługę API Management. Brak (wartość domyślna) oznacza, że usługa API Management nie jest częścią żadnego Virtual Network, zewnętrzne oznacza, że wdrożenie API Management jest skonfigurowane wewnątrz Virtual Network mającego punkt końcowy dostępny z Internetu, a wewnętrzny oznacza, że API Management wdrożenie jest konfigurowane wewnątrz Virtual Network tylko z punktem końcowym dostępnym w intranecie.
Nazwa | Typ | Opis |
---|---|---|
External |
string |
Usługa jest częścią Virtual Network i jest dostępna z Internetu. |
Internal |
string |
Usługa jest częścią Virtual Network i jest dostępna tylko z poziomu sieci wirtualnej. |
None |
string |
Usługa nie jest częścią żadnego Virtual Network. |