Partilhar via

Api Management Service - List

  • Referência
Serviço:
API Management
Versão da API:
2021-08-01

Lista todos os serviços Gestão de API numa subscrição do Azure.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service?api-version=2021-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
 path True

string

Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version
 query True

string

Versão da API a utilizar com o pedido de cliente.

Respostas

Name Tipo Description
200 OK

ApiManagementServiceListResult

A lista de serviços Gestão de API.
Other Status Codes

ErrorResponse

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

ApiManagementListServiceBySubscription

Pedido de amostra

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.ApiManagement/service?api-version=2021-08-01

Resposta da amostra

Código de estado:
200 
{
  "value": [
    {
      "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": "bar@contoso.com",
        "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-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": true,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "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-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": false,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "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-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": false,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "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
          }
        ],
        "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"
      },
      "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": "bar@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T09:40:00.7106733Z",
        "lastModifiedBy": "foo@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/vvktestcons",
      "name": "vvktestcons",
      "type": "Microsoft.ApiManagement/service",
      "tags": {
        "Owner": "vitaliik"
      },
      "location": "East US",
      "etag": "AAAAAAAWKwo=",
      "properties": {
        "publisherEmail": "bar@contoso.com",
        "publisherName": "vvktestcons",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2020-08-10T18:07:23.4565211Z",
        "gatewayUrl": "https://vvktestcons.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "vvktestcons.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
        },
        "virtualNetworkType": "None",
        "enableClientCertificate": false,
        "disableGateway": false,
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Consumption",
        "capacity": 0
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/OGF-Z3-06162021-Standard",
      "name": "OGF-Z3-06162021-Standard",
      "type": "Microsoft.ApiManagement/service",
      "tags": {},
      "location": "East US",
      "etag": "AAAAAAAWF7M=",
      "properties": {
        "publisherEmail": "bar@contoso.com",
        "publisherName": "Test Standard",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2021-06-16T09:39:58.6555759Z",
        "gatewayUrl": "https://ogf-z3-06162021-standard.azure-api.net",
        "gatewayRegionalUrl": "https://ogf-z3-06162021-standard-eastus-01.regional.azure-api.net",
        "portalUrl": "https://ogf-z3-06162021-standard.portal.azure-api.net",
        "developerPortalUrl": "https://ogf-z3-06162021-standard.developer.azure-api.net",
        "managementApiUrl": "https://ogf-z3-06162021-standard.management.azure-api.net",
        "scmUrl": "https://ogf-z3-06162021-standard.scm.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "ogf-z3-06162021-standard.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "publicIPAddresses": [
          "13.82.208.32"
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA": "true",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False"
        },
        "virtualNetworkType": "None",
        "disableGateway": false,
        "apiVersionConstraint": {
          "minApiVersion": "2019-12-01"
        },
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Standard",
        "capacity": 2
      },
      "identity": {
        "type": "SystemAssigned, UserAssigned",
        "principalId": "347a5800-ca99-475a-9202-fe38ca79ee41",
        "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": "bar@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T09:39:58.4591834Z",
        "lastModifiedBy": "bar@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-17T15:05:13.5494721Z"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/ogf-dev-060921",
      "name": "ogf-dev-060921",
      "type": "Microsoft.ApiManagement/service",
      "tags": {},
      "location": "East US",
      "etag": "AAAAAAAWEFg=",
      "properties": {
        "publisherEmail": "v-ssaiprasan@microsoft.com",
        "publisherName": "TechM",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2021-06-09T10:06:22.2133978Z",
        "gatewayUrl": "https://ogf-dev-060921.azure-api.net",
        "gatewayRegionalUrl": "https://ogf-dev-060921-eastus-01.regional.azure-api.net",
        "portalUrl": "https://ogf-dev-060921.portal.azure-api.net",
        "developerPortalUrl": "https://ogf-dev-060921.developer.azure-api.net",
        "managementApiUrl": "https://ogf-dev-060921.management.azure-api.net",
        "scmUrl": "https://ogf-dev-060921.scm.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "ogf-dev-060921.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "publicIPAddresses": [
          "168.62.39.172"
        ],
        "additionalLocations": [
          {
            "location": "South Central US",
            "sku": {
              "name": "Premium",
              "capacity": 9
            },
            "zones": [],
            "publicIPAddresses": [
              "13.84.208.29"
            ],
            "gatewayRegionalUrl": "https://ogf-dev-060921-southcentralus-01.regional.azure-api.net",
            "disableGateway": false
          }
        ],
        "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": [
          {
            "storeName": "Root",
            "certificate": {
              "expiry": "2021-11-25T22:51:47+00:00",
              "thumbprint": "4E8234312EC69245D1AE296C4882D46FB84076A3",
              "subject": "CN=*.apim.net"
            }
          }
        ],
        "disableGateway": false,
        "apiVersionConstraint": {
          "minApiVersion": "2019-12-01"
        },
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Premium",
        "capacity": 3
      },
      "identity": {
        "type": "SystemAssigned",
        "principalId": "c9bd4c05-205e-4431-b232-112cf2e9e0aa",
        "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd"
      },
      "systemData": {
        "createdBy": "v-ssaiprasan@microsoft.com",
        "createdByType": "User",
        "createdAt": "2021-06-09T10:06:21.7336597Z",
        "lastModifiedBy": "v-ssaiprasan@microsoft.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-10T14:27:05.546816Z"
      }
    }
  ]
}

Definições

Name Description
AdditionalLocation

Descrição de uma localização de recursos Gestão de API adicional.
ApiManagementServiceIdentity

Propriedades de identidade do recurso do serviço de Gestão de API.
ApiManagementServiceListResult

A resposta da operação Lista Gestão de API serviços.
ApiManagementServiceResource

Um único recurso de serviço Gestão de API em Listar ou Obter resposta.
ApiManagementServiceSkuProperties

Gestão de API propriedades do SKU do recurso de serviço.
ApimIdentityType

O tipo de identidade utilizado para o recurso. O tipo "SystemAssigned, UserAssigned" inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo utilizador. O tipo "Nenhum" removerá quaisquer identidades do serviço.
ApiVersionConstraint

Restrição da versão das Apis do Plano de Controlo para o serviço de Gestão de API.
ArmIdWrapper

Um wrapper para um ID de recurso do ARM
CertificateConfiguration

Configuração do certificado que consiste em intermediários não fidedignos e certificados de raiz.
CertificateInformation

Informações do certificado SSL.
CertificateSource

Origem do Certificado.
CertificateStatus

Estado do Certificado.
createdByType

O tipo de identidade que criou o recurso.
ErrorFieldContract

Contrato de Campo de Erro.
ErrorResponse

Resposta do Erro.
HostnameConfiguration

Configuração personalizada do nome de anfitrião.
HostnameType

Tipo de nome de anfitrião.
PlatformVersion

Versão da Plataforma de Computação a executar o serviço.
PrivateEndpointServiceConnectionStatus

O estado da ligação do ponto final privado.
PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor de serviços.
PublicNetworkAccess

Se o acesso ao ponto final público é ou não permitido para este serviço de Gestão de API. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado". Se "Desativado", os pontos finais privados são o método de acesso exclusivo. O valor predefinido é "Ativado"
RemotePrivateEndpointConnectionWrapper

Recurso de Ligação de Ponto Final Privado Remoto.
SkuType

Nome do SKU.
systemData

Metadados relativos à criação e última modificação do recurso.
UserIdentityProperties
VirtualNetworkConfiguration

Configuração de uma rede virtual para a qual Gestão de API serviço é implementado.
VirtualNetworkType

O tipo de VPN no qual Gestão de API serviço tem de ser configurado. Nenhum (Valor Predefinido) significa que o serviço Gestão de API não faz parte de nenhum Rede Virtual, Externo significa que a implementação do Gestão de API está configurada dentro de um Rede Virtual ter um Ponto Final Com Acesso à Internet e Interno significa que Gestão de API implementação está configurada dentro de um Rede Virtual ter apenas um Ponto Final Com Acesso à Intranet.

AdditionalLocation

Descrição de uma localização de recursos Gestão de API adicional.

Name Tipo Default value Description
disableGateway

boolean

False

Propriedade válida apenas para um serviço de Gestão de API implementado em várias localizações. Isto pode ser utilizado para desativar o gateway nesta localização adicional.
gatewayRegionalUrl

string

URL do gateway do serviço Gestão de API na Região.
location

string

O nome da localização da região adicional entre as regiões do Centro de Dados do Azure.
platformVersion

PlatformVersion

Versão da Plataforma de Computação a executar o serviço.
privateIPAddresses

string[]

Endereços IP com Balanceamento de Carga Estática Privada do serviço de Gestão de API que é implementado numa Rede Virtual Interna numa localização adicional específica. Disponível apenas para SKU Básico, Standard, Premium e Isolado.
publicIPAddresses

string[]

Endereços IP Com Balanceamento de Carga Estática Pública do serviço Gestão de API na localização adicional. Disponível apenas para SKU Básico, Standard, Premium e Isolado.
publicIpAddressId

string

Endereço IP baseado em IP V4 do SKU Standard público a ser associado ao serviço implementado Rede Virtual na localização. Suportado apenas para o SKU Premium que está a ser implementado no Rede Virtual.
sku

ApiManagementServiceSkuProperties

Propriedades de SKU do serviço Gestão de API.
virtualNetworkConfiguration

VirtualNetworkConfiguration

Configuração da rede virtual para a localização.
zones

string[]

Uma lista de zonas de disponibilidade que indica a origem do recurso.

ApiManagementServiceIdentity

Propriedades de identidade do recurso do serviço de Gestão de API.

Name Tipo Description
principalId

string

O ID principal da identidade.
tenantId

string

O ID do inquilino do cliente da identidade.
type

ApimIdentityType

O tipo de identidade utilizado para o recurso. O tipo "SystemAssigned, UserAssigned" inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo utilizador. O tipo "Nenhum" removerá quaisquer identidades do serviço.
userAssignedIdentities

<string,  UserIdentityProperties>

A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ApiManagementServiceListResult

A resposta da operação Lista Gestão de API serviços.

Name Tipo Description
nextLink

string

Ligar ao próximo conjunto de resultados. Não vazio se Value contiver uma lista incompleta de serviços Gestão de API.
value

ApiManagementServiceResource[]

Resultado da operação Lista Gestão de API serviços.

ApiManagementServiceResource

Um único recurso de serviço Gestão de API em Listar ou Obter resposta.

Name Tipo Default value Description
etag

string

ETag do recurso.
id

string

ID do Recurso.
identity

ApiManagementServiceIdentity

Identidade de serviço gerida do serviço de Gestão de API.
location

string

Localização do recurso.
name

string

Nome do recurso.
properties.additionalLocations

AdditionalLocation[]

Localizações adicionais do datacenter do serviço Gestão de API.
properties.apiVersionConstraint

ApiVersionConstraint

Restrição da versão das Apis do Plano de Controlo para o serviço Gestão de API.
properties.certificates

CertificateConfiguration[]

Lista de Certificados que têm de ser instalados no serviço Gestão de API. O máximo de certificados suportados que podem ser instalados é 10.
properties.createdAtUtc

string

Data UTC de criação do serviço Gestão de API. A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.
properties.customProperties

object

Propriedades personalizadas do serviço Gestão de API.
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 irá desativar a cifra TLS_RSA_WITH_3DES_EDE_CBC_SHA para todos os TLS(1.0, 1.1 e 1.2).
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 pode ser utilizada para desativar apenas o TLS 1.1.
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 pode ser utilizada para desativar o TLS 1.0 num serviço Gestão de API.
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11 pode ser utilizada para desativar apenas o TLS 1.1 para comunicações com back-ends.
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10 pode ser utilizada para desativar o TLS 1.0 para comunicações com back-ends.
A definição Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2 pode ser utilizada para ativar o protocolo HTTP2 num serviço Gestão de API.
Não especificar nenhuma destas propriedades na operação PATCH irá repor os valores das propriedades omitidas para as respetivas predefinições. Para todas as definições exceto Http2, o valor predefinido é True se o serviço foi criado em ou antes de 1 de abril de 2018 e False de outra forma. O valor predefinido da definição http2 é False.

Pode desativar qualquer uma das seguintes cifras com as definições Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]: TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA256, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA. Por exemplo, Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256:false. O valor predefinido é true para eles.
Nota: as cifras seguintes não podem ser desativadas, uma vez que são necessárias por componentes internos da plataforma: TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
properties.developerPortalUrl

string

URL do ponto final do Portal do DEveloper do serviço Gestão de API.
properties.disableGateway

boolean

False

Propriedade apenas válida para um serviço de Gestão de API implementado em várias localizações. Isto pode ser utilizado para desativar o gateway na região mestra.
properties.enableClientCertificate

boolean

False

A propriedade destina-se apenas a ser utilizada para o Serviço SKU de Consumo. Isto impõe a apresentação de um certificado de cliente em cada pedido ao gateway. Isto também permite autenticar o certificado na política no gateway.
properties.gatewayRegionalUrl

string

URL do gateway do serviço Gestão de API na Região Predefinida.
properties.gatewayUrl

string

URL do gateway do serviço Gestão de API.
properties.hostnameConfigurations

HostnameConfiguration[]

Configuração personalizada do nome de anfitrião do serviço Gestão de API.
properties.managementApiUrl

string

URL do ponto final da API de Gestão do serviço Gestão de API.
properties.notificationSenderEmail

string

Email endereço a partir do qual a notificação será enviada.
properties.platformVersion

PlatformVersion

Versão da Plataforma de Computação a executar o serviço nesta localização.
properties.portalUrl

string

Url de ponto final do portal do Publisher do serviço Gestão de API.
properties.privateEndpointConnections

RemotePrivateEndpointConnectionWrapper[]

Lista de Ligações de Ponto Final Privado deste serviço.
properties.privateIPAddresses

string[]

Endereços IP com Balanceamento de Carga Estático Privado do serviço de Gestão de API na região Primária que é implementado numa Rede Virtual Interna. Disponível apenas para SKU Básico, Standard, Premium e Isolado.
properties.provisioningState

string

O estado de aprovisionamento atual do serviço Gestão de API, que pode ser um dos seguintes: Criado/Ativado/Com Êxito/Atualização/Com Falhas/Parado/Terminação/Terminação Falhada/Eliminada.
properties.publicIPAddresses

string[]

Endereços IP com Balanceamento de Carga Estático Público do serviço Gestão de API na região Primária. Disponível apenas para SKU Básico, Standard, Premium e Isolado.
properties.publicIpAddressId

string

Endereço IP V4 baseado em IP do SKU Standard Público a ser associado a Rede Virtual serviço implementado na região. Suportada apenas para o Programador e o SKU Premium que está a ser implementado no Rede Virtual.
properties.publicNetworkAccess

PublicNetworkAccess

Se o acesso ao ponto final público é ou não permitido para este serviço de Gestão de API. O valor é opcional, mas, se for transmitido, tem de ser "Ativado" ou "Desativado". Se "Desativado", os pontos finais privados são o método de acesso exclusivo. O valor predefinido é "Ativado"
properties.publisherEmail

string

E-mail do publicador.
properties.publisherName

string

Nome do publicador.
properties.restore

boolean

False

Anular a eliminação do Serviço de Gestão de API se tiver sido eliminado de forma recuperável anteriormente. Se este sinalizador for especificado e definido como Verdadeiro, todas as outras propriedades serão ignoradas.
properties.scmUrl

string

URL do ponto final SCM do serviço Gestão de API.
properties.targetProvisioningState

string

O estado de aprovisionamento do serviço Gestão de API, que é visado pela operação de execução prolongada iniciada no serviço.
properties.virtualNetworkConfiguration

VirtualNetworkConfiguration

Configuração da rede virtual do serviço Gestão de API.
properties.virtualNetworkType

VirtualNetworkType

None

O tipo de VPN na qual Gestão de API serviço tem de ser configurado. Nenhum (Valor Predefinido) significa que o serviço Gestão de API não faz parte de nenhuma Rede Virtual, Externo significa que a implementação Gestão de API está configurada num Rede Virtual ter um Ponto Final Com Acesso à Internet e Interno significa que Gestão de API implementação está configurada dentro de um Rede Virtual ter apenas um Ponto Final Com Acesso à Intranet.
sku

ApiManagementServiceSkuProperties

Propriedades do SKU do serviço Gestão de API.
systemData

systemData

Metadados relativos à criação e última modificação do recurso.
tags

object

Etiquetas de recursos.
type

string

O tipo de recurso para Gestão de API recurso está definido como Microsoft.ApiManagement.
zones

string[]

Uma lista de zonas de disponibilidade que indica de onde o recurso precisa de vir.

ApiManagementServiceSkuProperties

Gestão de API propriedades do SKU do recurso de serviço.

Name Tipo Description
capacity

integer

Capacidade do SKU (número de unidades implementadas do SKU). Para a capacidade de SKU de Consumo tem de ser especificada como 0.
name

SkuType

Nome do SKU.

ApimIdentityType

O tipo de identidade utilizado para o recurso. O tipo "SystemAssigned, UserAssigned" inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo utilizador. O tipo "Nenhum" removerá quaisquer identidades do serviço.

Name Tipo Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ApiVersionConstraint

Restrição da versão das Apis do Plano de Controlo para o serviço de Gestão de API.

Name Tipo Description
minApiVersion

string

Limite as chamadas à API do plano de controlo para Gestão de API serviço com uma versão igual ou mais recente do que este valor.

ArmIdWrapper

Um wrapper para um ID de recurso do ARM

Name Tipo Description
id

string

CertificateConfiguration

Configuração do certificado que consiste em intermediários não fidedignos e certificados de raiz.

Name Tipo Description
certificate

CertificateInformation

Informações do certificado.
certificatePassword

string

Palavra-passe do Certificado.
encodedCertificate

string

Certificado codificado base64.
storeName enum:
  • CertificateAuthority
  • Root

A localização do arquivo de certificados System.Security.Cryptography.x509certificates.StoreName. Apenas Root e CertificateAuthority são localizações válidas.

CertificateInformation

Informações do certificado SSL.

Name Tipo Description
expiry

string

Data de expiração do certificado. A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.
subject

string

Assunto do certificado.
thumbprint

string

Impressão digital do certificado.

CertificateSource

Origem do Certificado.

Name Tipo Description
BuiltIn

string

Custom

string

KeyVault

string

Managed

string

CertificateStatus

Estado do Certificado.

Name Tipo Description
Completed

string

Failed

string

InProgress

string

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorFieldContract

Contrato de Campo de Erro.

Name Tipo Description
code

string

Código de erro de nível de propriedade.
message

string

Representação legível por humanos do erro ao nível da propriedade.
target

string

Nome da propriedade.

ErrorResponse

Resposta do Erro.

Name Tipo Description
error.code

string

Código de erro definido pelo serviço. Este código serve como um subestado para o código de erro HTTP especificado na resposta.
error.details

ErrorFieldContract[]

A lista de campos inválidos enviados no pedido, em caso de erro de validação.
error.message

string

Representação legível por humanos do erro.

HostnameConfiguration

Configuração personalizada do nome de anfitrião.

Name Tipo Default value Description
certificate

CertificateInformation

Informações do certificado.
certificatePassword

string

Palavra-passe do Certificado.
certificateSource

CertificateSource

Origem do Certificado.
certificateStatus

CertificateStatus

Estado do Certificado.
defaultSslBinding

boolean

False

Especifique true para configurar o certificado associado a este Nome de Anfitrião como o Certificado SSL Predefinido. Se um cliente não enviar o cabeçalho SNI, este será o certificado que será contestado. A propriedade é útil se um serviço tiver vários nomes de anfitrião personalizados ativados e precisar de decidir sobre o certificado ssl predefinido. A definição só é aplicada ao Tipo de Nome de Anfitrião do Proxy.
encodedCertificate

string

Certificado codificado Base64.
hostName

string

Nome do anfitrião a configurar no serviço de Gestão de API.
identityClientId

string

ClientId de identidade gerida atribuída pelo sistema ou pelo utilizador, tal como gerado pelo Azure AD, que tem acesso GET ao keyVault que contém o certificado SSL.
keyVaultId

string

Url para o Segredo do KeyVault que contém o Certificado SSL. Se for fornecido um URL absoluto que contenha a versão, a atualização automática do certificado SSL não funcionará. Isto requer que o serviço de Gestão de API seja configurado com aka.ms/apimmsi. O segredo deve ser do tipo application/x-pkcs12
negotiateClientCertificate

boolean

False

Especifique true para negociar sempre o certificado de cliente no nome do anfitrião. O Valor Predefinido é falso.
type

HostnameType

Tipo de nome de anfitrião.

HostnameType

Tipo de nome de anfitrião.

Name Tipo Description
DeveloperPortal

string

Management

string

Portal

string

Proxy

string

Scm

string

PlatformVersion

Versão da Plataforma de Computação a executar o serviço.

Name Tipo Description
mtv1

string

Plataforma a executar o serviço na plataforma Multi Tenant V1.
stv1

string

Plataforma a executar o serviço na plataforma V1 de Inquilino Único.
stv2

string

Plataforma a executar o serviço na plataforma V2 de Inquilino Único.
undetermined

string

Não é possível determinar a versão da plataforma, uma vez que a plataforma de computação não está implementada.

PrivateEndpointServiceConnectionStatus

O estado da ligação do ponto final privado.

Name Tipo Description
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor de serviços.

Name Tipo Description
actionsRequired

string

Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor.
description

string

O motivo da aprovação/rejeição da ligação.
status

PrivateEndpointServiceConnectionStatus

Indica se a ligação foi Aprovada/Rejeitada/Removida pelo proprietário do serviço.

PublicNetworkAccess

Se o acesso ao ponto final público é ou não permitido para este serviço de Gestão de API. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado". Se "Desativado", os pontos finais privados são o método de acesso exclusivo. O valor predefinido é "Ativado"

Name Tipo Description
Disabled

string

Enabled

string

RemotePrivateEndpointConnectionWrapper

Recurso de Ligação de Ponto Final Privado Remoto.

Name Tipo Description
id

string

ID do recurso de ligação de Ponto Final Privado
name

string

Nome da Ligação de Ponto Final Privado
properties.groupIds

string[]

Todos os IDs do Grupo.
properties.privateEndpoint

ArmIdWrapper

O recurso do ponto final privado.
properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor de serviços.
properties.provisioningState

string

O estado de aprovisionamento do recurso de ligação de ponto final privado.
type

string

Tipo de Recurso de Ligação de Ponto Final Privado

SkuType

Nome do SKU.

Name Tipo Description
Basic

string

SKU Básico da Gestão de API.
Consumption

string

SKU de Consumo da Gestão de API.
Developer

string

SKU do Programador da Gestão de API.
Isolated

string

SKU isolado da Gestão de API.
Premium

string

SKU Premium da Gestão de API.
Standard

string

SKU Standard da Gestão de API.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

UserIdentityProperties

Name Tipo Description
clientId

string

O ID de cliente da identidade atribuída pelo utilizador.
principalId

string

O ID principal da identidade atribuída pelo utilizador.

VirtualNetworkConfiguration

Configuração de uma rede virtual para a qual Gestão de API serviço é implementado.

Name Tipo Description
subnetResourceId

string

O ID de recurso completo de uma sub-rede numa rede virtual para implementar o serviço Gestão de API.
subnetname

string

O nome da sub-rede.
vnetid

string

O ID da rede virtual. Normalmente, trata-se de um GUID. Espere um GUID nulo por predefinição.

VirtualNetworkType

O tipo de VPN no qual Gestão de API serviço tem de ser configurado. Nenhum (Valor Predefinido) significa que o serviço Gestão de API não faz parte de nenhum Rede Virtual, Externo significa que a implementação do Gestão de API está configurada dentro de um Rede Virtual ter um Ponto Final Com Acesso à Internet e Interno significa que Gestão de API implementação está configurada dentro de um Rede Virtual ter apenas um Ponto Final Com Acesso à Intranet.

Name Tipo Description
External

string

O serviço faz parte de Rede Virtual e está acessível a partir da Internet.
Internal

string

O serviço faz parte de Rede Virtual e só está acessível a partir da rede virtual.
None

string

O serviço não faz parte de nenhuma Rede Virtual.