Api Management Service - Update
Novedades un servicio de API Management existente.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}?api-version=2022-08-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
service
|
path | True |
string |
Nombre del servicio API Management. Patrón de Regex: |
subscription
|
path | True |
string |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
identity |
Identidad de servicio administrada del servicio Api Management. |
|
properties.additionalLocations |
Ubicaciones adicionales del centro de datos del servicio API Management. |
|
properties.apiVersionConstraint |
Restricción de versión de api de plano de control para el servicio API Management. |
|
properties.certificates |
Lista de certificados que deben instalarse en el servicio API Management. El número máximo de certificados admitidos que se pueden instalar es 10. |
|
properties.customProperties |
object |
Propiedades personalizadas del servicio API Management. |
properties.disableGateway |
boolean |
La propiedad solo es válida para un servicio api Management implementado en varias ubicaciones. Esto se puede usar para deshabilitar la puerta de enlace en la región maestra. |
properties.enableClientCertificate |
boolean |
Propiedad solo diseñada para usarse para el servicio de SKU de consumo. Esto exige que se presente un certificado de cliente en cada solicitud a la puerta de enlace. Esto también permite autenticar el certificado en la directiva de la puerta de enlace. |
properties.hostnameConfigurations |
Configuración de nombre de host personalizada del servicio API Management. |
|
properties.natGatewayState |
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management. |
|
properties.notificationSenderEmail |
string |
Email dirección desde la que se enviará la notificación. |
properties.privateEndpointConnections |
Lista de conexiones de punto de conexión privado de este servicio. |
|
properties.publicIpAddressId |
string |
Dirección IP V4 basada en la SKU estándar pública que se va a asociar con Virtual Network servicio implementado en la región. Solo se admite para la implementación de SKU Developer y Premium en Virtual Network. |
properties.publicNetworkAccess |
Si se permite o no el acceso al punto de conexión público para este servicio API Management. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". Si "Disabled", los puntos de conexión privados son el método de acceso exclusivo. El valor predeterminado es "Enabled" |
|
properties.publisherEmail |
string |
Correo electrónico del publicador. |
properties.publisherName |
string |
Nombre del publicador. |
properties.restore |
boolean |
Quite el servicio Api Management si anteriormente se eliminó temporalmente. Si se especifica esta marca y se establece en True se omitirán todas las demás propiedades. |
properties.virtualNetworkConfiguration |
Configuración de red virtual del servicio API Management. |
|
properties.virtualNetworkType |
Tipo de VPN en el que se debe configurar API Management servicio. Ninguno (valor predeterminado) significa que el servicio API Management no forma parte de ninguna Virtual Network, external significa que la implementación de API Management se configura dentro de un Virtual Network que tiene un punto de conexión accesible desde Internet y significa internamente que API Management la implementación se configura dentro de un Virtual Network tener solo un punto de conexión accesible desde la intranet. |
|
sku |
Propiedades de SKU del servicio API Management. |
|
tags |
object |
Etiquetas del recurso. |
zones |
string[] |
Una lista de zonas de disponibilidad que indica dónde debe proceder el recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
El servicio se actualizó correctamente. |
|
202 Accepted |
Se aceptó la solicitud de actualización del servicio. |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
Api |
Api |
Api |
ApiManagementUpdateServiceDisableTls10
Solicitud de ejemplo
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
{
"properties": {
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false"
}
}
}
Respuesta de muestra
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"tags": {
"Owner": "sasolank",
"UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
"Reserved": "",
"TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
"Pool": "Manual",
"TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
},
"location": "West US",
"etag": "AAAAAAAYRPs=",
"properties": {
"publisherEmail": "admin@live.com",
"publisherName": "Contoso",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2017-06-29T17:50:42.3191122Z",
"gatewayUrl": "https://apimService1.azure-api.net",
"portalUrl": "https://apimService1.portal.azure-api.net",
"managementApiUrl": "https://apimService1.management.azure-api.net",
"scmUrl": "https://apimService1.scm.azure-api.net",
"hostnameConfigurations": [],
"publicIPAddresses": [
"40.86.176.232"
],
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
},
"virtualNetworkType": "None"
},
"sku": {
"name": "Standard",
"capacity": 1
}
}
ApiManagementUpdateServicePublisherDetails
Solicitud de ejemplo
Respuesta de muestra
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"tags": {
"Owner": "sasolank",
"UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
"Reserved": "",
"TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
"Pool": "Manual",
"TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
},
"location": "West US",
"etag": "AAAAAAAYRPs=",
"properties": {
"publisherEmail": "foobar@live.com",
"publisherName": "Contoso Vnext",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2017-06-29T17:50:42.3191122Z",
"gatewayUrl": "https://apimService1.azure-api.net",
"portalUrl": "https://apimService1.portal.azure-api.net",
"managementApiUrl": "https://apimService1.management.azure-api.net",
"scmUrl": "https://apimService1.scm.azure-api.net",
"hostnameConfigurations": [],
"publicIPAddresses": [
"40.86.176.232"
],
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
},
"virtualNetworkType": "None"
},
"sku": {
"name": "Standard",
"capacity": 1
}
}
ApiManagementUpdateServiceToNewVnetAndAvailabilityZones
Solicitud de ejemplo
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
{
"properties": {
"additionalLocations": [
{
"location": "Australia East",
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
},
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip"
}
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet-apim-japaneast/subnets/apim2"
},
"virtualNetworkType": "External",
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/publicip-apim-japan-east"
},
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
]
}
Respuesta de muestra
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"location": "Japan East",
"etag": "AAAAAAAWBIU=",
"properties": {
"publisherEmail": "contoso@microsoft.com",
"publisherName": "apimPublisher",
"notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2021-04-08T23:41:35.6447381Z",
"gatewayUrl": "https://apimService1.azure-api.net",
"gatewayRegionalUrl": "https://apimService1-japaneast-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": "mycustomdomain.int-azure-api.net",
"negotiateClientCertificate": false,
"certificate": {
"expiry": "2022-06-09T23:59:59+00:00",
"thumbprint": "2994B5FFB8F76B3C687D324A8DEE0432C1ED18CD",
"subject": "CN=mycustomdomain.int-azure-api.net"
},
"defaultSslBinding": true,
"certificateSource": "Managed"
}
],
"publicIPAddresses": [
"20.78.248.217"
],
"additionalLocations": [
{
"location": "Australia East",
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
],
"publicIPAddresses": [
"20.213.1.35"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
},
"gatewayRegionalUrl": "https://apimService1-australiaeast-01.regional.azure-api.net",
"disableGateway": false,
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip",
"platformVersion": "stv2"
}
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet-apim-japaneast/subnets/apim2"
},
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_GCM_SHA256": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_256_CBC_SHA256": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_256_CBC_SHA": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA": "false",
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
"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.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": "Internal",
"disableGateway": false,
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/publicip-apim-japan-east",
"publicNetworkAccess": "Enabled",
"platformVersion": "stv2"
},
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
],
"systemData": {
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-01-21T20:04:21.6108974Z"
}
}
Definiciones
Nombre | Description |
---|---|
Additional |
Descripción de una ubicación de recursos API Management adicional. |
Api |
Propiedades de identidad del recurso del servicio Api Management. |
Api |
Un único recurso de servicio API Management en Lista o Obtención de respuesta. |
Api |
API Management propiedades de SKU de recursos de servicio. |
Api |
Parámetro proporcionado a Update Api Management Service. |
Apim |
Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del servicio. |
Api |
Restricción de versión de api de plano de control para el servicio API Management. |
Arm |
Contenedor para un identificador de recurso de ARM |
Certificate |
Configuración de certificado que consta de certificados intermedios y certificados raíz que no son de confianza. |
Certificate |
Información del certificado SSL. |
Certificate |
Origen del certificado. |
Certificate |
Estado del certificado. |
created |
Tipo de identidad que creó el recurso. |
Error |
Contrato de campo de error. |
Error |
Respuesta de error. |
Hostname |
Configuración de nombre de host personalizada. |
Hostname |
Tipo de nombre de host. |
Nat |
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management. |
Platform |
Versión de la plataforma de proceso que ejecuta el servicio. |
Private |
Estado de conexión del punto de conexión privado. |
Private |
Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor. |
Public |
Si se permite o no el acceso al punto de conexión público para este servicio API Management. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". Si "Disabled", los puntos de conexión privados son el método de acceso exclusivo. El valor predeterminado es "Enabled" |
Remote |
Recurso de conexión de punto de conexión privado remoto. |
Sku |
Nombre de la SKU. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
User |
|
Virtual |
Configuración de una red virtual en la que se implementa API Management servicio. |
Virtual |
Tipo de VPN en el que se debe configurar API Management servicio. Ninguno (valor predeterminado) significa que el servicio API Management no forma parte de ninguna Virtual Network, external significa que la implementación de API Management se configura dentro de un Virtual Network que tiene un punto de conexión accesible desde Internet y significa internamente que API Management la implementación se configura dentro de un Virtual Network tener solo un punto de conexión accesible desde la intranet. |
AdditionalLocation
Descripción de una ubicación de recursos API Management adicional.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
disableGateway |
boolean |
False |
La propiedad solo es válida para un servicio api Management implementado en varias ubicaciones. Esto se puede usar para deshabilitar la puerta de enlace en esta ubicación adicional. |
gatewayRegionalUrl |
string |
Dirección URL de puerta de enlace del servicio API Management en la región. |
|
location |
string |
Nombre de ubicación de la región adicional entre las regiones del centro de datos de Azure. |
|
natGatewayState | Disabled |
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management. |
|
outboundPublicIPAddresses |
string[] |
Prefijos de dirección IPV4 públicas de salida asociados al servicio implementado de puerta de enlace NAT. Disponible solo para SKU Premium en la plataforma stv2. |
|
platformVersion |
Versión de la plataforma de proceso que ejecuta el servicio. |
||
privateIPAddresses |
string[] |
Direcciones IP de carga equilibrada estática privada del servicio API Management que se implementa en un Virtual Network interno en una ubicación adicional determinada. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
publicIPAddresses |
string[] |
Direcciones IP públicas de carga equilibrada estática del servicio API Management en la ubicación adicional. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
publicIpAddressId |
string |
Dirección IP V4 basada en la SKU estándar pública que se va a asociar con Virtual Network servicio implementado en la ubicación. Solo se admite para la SKU Premium que se implementa en Virtual Network. |
|
sku |
Propiedades de SKU del servicio API Management. |
||
virtualNetworkConfiguration |
Configuración de red virtual para la ubicación. |
||
zones |
string[] |
Una lista de zonas de disponibilidad que indica dónde debe proceder el recurso. |
ApiManagementServiceIdentity
Propiedades de identidad del recurso del servicio Api Management.
Nombre | Tipo | Description |
---|---|---|
principalId |
string |
Identificador de entidad de seguridad de la identidad. |
tenantId |
string |
Identificador de inquilino del cliente de la identidad. |
type |
Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del servicio. |
|
userAssignedIdentities |
<string,
User |
Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ApiManagementServiceResource
Un único recurso de servicio API Management en Lista o Obtención de respuesta.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
etag |
string |
ETag del recurso. |
|
id |
string |
Identificador del recurso. |
|
identity |
Identidad de servicio administrada del servicio Api Management. |
||
location |
string |
Ubicación del recurso |
|
name |
string |
Nombre del recurso. |
|
properties.additionalLocations |
Ubicaciones adicionales del centro de datos del servicio API Management. |
||
properties.apiVersionConstraint |
Restricción de versión de api de plano de control para el servicio API Management. |
||
properties.certificates |
Lista de certificados que deben instalarse en el servicio API Management. El número máximo de certificados admitidos que se pueden instalar es 10. |
||
properties.createdAtUtc |
string |
Fecha UTC de creación del servicio API Management. La fecha se ajusta al siguiente formato: |
|
properties.customProperties |
object |
Propiedades personalizadas del servicio API Management. |
|
properties.developerPortalUrl |
string |
Dirección URL del punto de conexión del portal de DEveloper del servicio API Management. |
|
properties.disableGateway |
boolean |
False |
La propiedad solo es válida para un servicio api Management implementado en varias ubicaciones. Esto se puede usar para deshabilitar la puerta de enlace en la región maestra. |
properties.enableClientCertificate |
boolean |
False |
Propiedad solo diseñada para usarse para el servicio de SKU de consumo. Esto exige que se presente un certificado de cliente en cada solicitud a la puerta de enlace. Esto también permite autenticar el certificado en la directiva de la puerta de enlace. |
properties.gatewayRegionalUrl |
string |
Dirección URL de puerta de enlace del servicio API Management en la región predeterminada. |
|
properties.gatewayUrl |
string |
Dirección URL de puerta de enlace del servicio API Management. |
|
properties.hostnameConfigurations |
Configuración de nombre de host personalizada del servicio API Management. |
||
properties.managementApiUrl |
string |
Dirección URL del punto de conexión de la API de administración del servicio API Management. |
|
properties.natGatewayState | Disabled |
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management. |
|
properties.notificationSenderEmail |
string |
Email dirección desde la que se enviará la notificación. |
|
properties.outboundPublicIPAddresses |
string[] |
Prefijos de dirección IPV4 públicas de salida asociados al servicio implementado de puerta de enlace NAT. Disponible solo para SKU Premium en la plataforma stv2. |
|
properties.platformVersion |
Versión de la plataforma de proceso que ejecuta el servicio en esta ubicación. |
||
properties.portalUrl |
string |
Dirección URL del punto de conexión del portal del publicador del servicio API Management. |
|
properties.privateEndpointConnections |
Lista de conexiones de punto de conexión privado de este servicio. |
||
properties.privateIPAddresses |
string[] |
Direcciones IP de carga equilibrada estática privada del servicio API Management en la región primaria que se implementa en un Virtual Network interno. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
properties.provisioningState |
string |
El estado de aprovisionamiento actual del servicio API Management que puede ser uno de los siguientes: Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted. |
|
properties.publicIPAddresses |
string[] |
Direcciones IP públicas de carga equilibrada estática del servicio API Management en la región primaria. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
properties.publicIpAddressId |
string |
Dirección IP V4 basada en la SKU estándar pública que se va a asociar con Virtual Network servicio implementado en la región. Solo se admite para la implementación de SKU Developer y Premium en Virtual Network. |
|
properties.publicNetworkAccess |
Si se permite o no el acceso al punto de conexión público para este servicio API Management. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". Si "Disabled", los puntos de conexión privados son el método de acceso exclusivo. El valor predeterminado es "Enabled" |
||
properties.publisherEmail |
string |
Correo electrónico del publicador. |
|
properties.publisherName |
string |
Nombre del publicador. |
|
properties.restore |
boolean |
False |
Quite el servicio Api Management si anteriormente se eliminó temporalmente. Si se especifica esta marca y se establece en True se omitirán todas las demás propiedades. |
properties.scmUrl |
string |
Dirección URL del punto de conexión de SCM del servicio API Management. |
|
properties.targetProvisioningState |
string |
Estado de aprovisionamiento del servicio API Management, que está destinado a la operación de larga duración iniciada en el servicio. |
|
properties.virtualNetworkConfiguration |
Configuración de red virtual del servicio API Management. |
||
properties.virtualNetworkType | None |
Tipo de VPN en el que se debe configurar API Management servicio. Ninguno (valor predeterminado) significa que el servicio API Management no forma parte de ninguna Virtual Network, external significa que la implementación de API Management se configura dentro de un Virtual Network que tiene un punto de conexión accesible desde Internet y significa internamente que API Management la implementación se configura dentro de un Virtual Network tener solo un punto de conexión accesible desde la intranet. |
|
sku |
Propiedades de SKU del servicio API Management. |
||
systemData |
Metadatos relacionados con la creación y la última modificación del recurso. |
||
tags |
object |
Etiquetas del recurso. |
|
type |
string |
El tipo de recurso para API Management recurso se establece en Microsoft.ApiManagement. |
|
zones |
string[] |
Una lista de zonas de disponibilidad que indica dónde debe proceder el recurso. |
ApiManagementServiceSkuProperties
API Management propiedades de SKU de recursos de servicio.
Nombre | Tipo | Description |
---|---|---|
capacity |
integer |
Capacidad de la SKU (número de unidades implementadas de la SKU). Para la capacidad de SKU de consumo debe especificarse como 0. |
name |
Nombre de la SKU. |
ApiManagementServiceUpdateParameters
Parámetro proporcionado a Update Api Management Service.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
etag |
string |
ETag del recurso. |
|
id |
string |
Identificador del recurso. |
|
identity |
Identidad de servicio administrada del servicio Api Management. |
||
name |
string |
Nombre del recurso. |
|
properties.additionalLocations |
Ubicaciones adicionales del centro de datos del servicio API Management. |
||
properties.apiVersionConstraint |
Restricción de versión de api de plano de control para el servicio API Management. |
||
properties.certificates |
Lista de certificados que deben instalarse en el servicio API Management. El número máximo de certificados admitidos que se pueden instalar es 10. |
||
properties.createdAtUtc |
string |
Fecha UTC de creación del servicio API Management. La fecha se ajusta al siguiente formato: |
|
properties.customProperties |
object |
Propiedades personalizadas del servicio API Management. |
|
properties.developerPortalUrl |
string |
Dirección URL del punto de conexión del portal de DEveloper del servicio API Management. |
|
properties.disableGateway |
boolean |
False |
La propiedad solo es válida para un servicio api Management implementado en varias ubicaciones. Esto se puede usar para deshabilitar la puerta de enlace en la región maestra. |
properties.enableClientCertificate |
boolean |
False |
Propiedad solo diseñada para usarse para el servicio de SKU de consumo. Esto exige que se presente un certificado de cliente en cada solicitud a la puerta de enlace. Esto también permite autenticar el certificado en la directiva de la puerta de enlace. |
properties.gatewayRegionalUrl |
string |
Dirección URL de puerta de enlace del servicio API Management en la región predeterminada. |
|
properties.gatewayUrl |
string |
Dirección URL de puerta de enlace del servicio API Management. |
|
properties.hostnameConfigurations |
Configuración de nombre de host personalizada del servicio API Management. |
||
properties.managementApiUrl |
string |
Dirección URL del punto de conexión de la API de administración del servicio API Management. |
|
properties.natGatewayState | Disabled |
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management. |
|
properties.notificationSenderEmail |
string |
Email dirección desde la que se enviará la notificación. |
|
properties.outboundPublicIPAddresses |
string[] |
Prefijos de dirección IPV4 públicas de salida asociados al servicio implementado de puerta de enlace NAT. Disponible solo para SKU Premium en la plataforma stv2. |
|
properties.platformVersion |
Versión de la plataforma de proceso que ejecuta el servicio en esta ubicación. |
||
properties.portalUrl |
string |
Dirección URL del punto de conexión del portal del publicador del servicio API Management. |
|
properties.privateEndpointConnections |
Lista de conexiones de punto de conexión privado de este servicio. |
||
properties.privateIPAddresses |
string[] |
Direcciones IP de carga equilibrada estática privada del servicio API Management en la región primaria que se implementa en un Virtual Network interno. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
properties.provisioningState |
string |
El estado de aprovisionamiento actual del servicio API Management que puede ser uno de los siguientes: Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted. |
|
properties.publicIPAddresses |
string[] |
Direcciones IP públicas de carga equilibrada estática del servicio API Management en la región primaria. Solo está disponible para la SKU básica, estándar, premium y aislada. |
|
properties.publicIpAddressId |
string |
Dirección IP V4 basada en la SKU estándar pública que se va a asociar con Virtual Network servicio implementado en la región. Solo se admite para la implementación de SKU Developer y Premium en Virtual Network. |
|
properties.publicNetworkAccess |
Si se permite o no el acceso al punto de conexión público para este servicio API Management. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". Si "Disabled", los puntos de conexión privados son el método de acceso exclusivo. El valor predeterminado es "Enabled" |
||
properties.publisherEmail |
string |
Correo electrónico del publicador. |
|
properties.publisherName |
string |
Nombre del publicador. |
|
properties.restore |
boolean |
False |
Quite el servicio Api Management si anteriormente se eliminó temporalmente. Si se especifica esta marca y se establece en True se omitirán todas las demás propiedades. |
properties.scmUrl |
string |
Dirección URL del punto de conexión de SCM del servicio API Management. |
|
properties.targetProvisioningState |
string |
Estado de aprovisionamiento del servicio API Management, que está destinado a la operación de larga duración iniciada en el servicio. |
|
properties.virtualNetworkConfiguration |
Configuración de red virtual del servicio API Management. |
||
properties.virtualNetworkType | None |
Tipo de VPN en el que se debe configurar API Management servicio. Ninguno (valor predeterminado) significa que el servicio API Management no forma parte de ninguna Virtual Network, external significa que la implementación de API Management se configura dentro de un Virtual Network que tiene un punto de conexión accesible desde Internet y significa internamente que API Management la implementación se configura dentro de un Virtual Network tener solo un punto de conexión accesible desde la intranet. |
|
sku |
Propiedades de SKU del servicio API Management. |
||
tags |
object |
Etiquetas del recurso. |
|
type |
string |
El tipo de recurso para API Management recurso se establece en Microsoft.ApiManagement. |
|
zones |
string[] |
Una lista de zonas de disponibilidad que indica dónde debe proceder el recurso. |
ApimIdentityType
Tipo de identidad que se usa para el recurso. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del servicio.
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
ApiVersionConstraint
Restricción de versión de api de plano de control para el servicio API Management.
Nombre | Tipo | Description |
---|---|---|
minApiVersion |
string |
Limite las llamadas API del plano de control a API Management servicio con la versión igual o posterior a este valor. |
ArmIdWrapper
Contenedor para un identificador de recurso de ARM
Nombre | Tipo | Description |
---|---|---|
id |
string |
CertificateConfiguration
Configuración de certificado que consta de certificados intermedios y certificados raíz que no son de confianza.
Nombre | Tipo | Description |
---|---|---|
certificate |
Información del certificado. |
|
certificatePassword |
string |
Contraseña del certificado. |
encodedCertificate |
string |
Certificado codificado en Base64. |
storeName |
enum:
|
Ubicación del almacén de certificados System.Security.Cryptography.x509certificates.StoreName. Solo root y CertificateAuthority son ubicaciones válidas. |
CertificateInformation
Información del certificado SSL.
Nombre | Tipo | Description |
---|---|---|
expiry |
string |
Fecha de expiración del certificado. La fecha se ajusta al siguiente formato: |
subject |
string |
Asunto del certificado. |
thumbprint |
string |
Huella digital del certificado |
CertificateSource
Origen del certificado.
Nombre | Tipo | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
KeyVault |
string |
|
Managed |
string |
CertificateStatus
Estado del certificado.
Nombre | Tipo | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorFieldContract
Contrato de campo de error.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error de nivel de propiedad. |
message |
string |
Representación legible del error de nivel de propiedad. |
target |
string |
Nombre de propiedad. |
ErrorResponse
Respuesta de error.
Nombre | Tipo | Description |
---|---|---|
error.code |
string |
Código del error definido por el servicio. Este código funciona como estado secundario del código de error HTTP especificado en la respuesta. |
error.details |
La lista de campos no válidos que se envían en la solicitud, en caso de error de validación. |
|
error.message |
string |
Representación legible del error. |
HostnameConfiguration
Configuración de nombre de host personalizada.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
certificate |
Información del certificado. |
||
certificatePassword |
string |
Contraseña del certificado. |
|
certificateSource |
Origen del certificado. |
||
certificateStatus |
Estado del certificado. |
||
defaultSslBinding |
boolean |
False |
Especifique true para configurar el certificado asociado a este nombre de host como certificado SSL predeterminado. Si un cliente no envía el encabezado SNI, será el certificado que se impugnará. La propiedad es útil si un servicio tiene habilitado varios nombres de host personalizados y debe decidir el certificado ssl predeterminado. La configuración solo se aplica al tipo de nombre de host de puerta de enlace. |
encodedCertificate |
string |
Certificado codificado en Base64. |
|
hostName |
string |
Nombre de host que se va a configurar en el servicio Api Management. |
|
identityClientId |
string |
ClientId de identidad administrada asignada por el sistema o el usuario, según lo generado por Azure AD, que tiene acceso GET al almacén de claves que contiene el certificado SSL. |
|
keyVaultId |
string |
Dirección URL al secreto de KeyVault que contiene el certificado Ssl. Si se proporciona la dirección URL absoluta que contiene la versión, la actualización automática del certificado ssl no funcionará. Esto requiere que el servicio Api Management se configure con aka.ms/apimmsi. El secreto debe ser de tipo application/x-pkcs12. |
|
negotiateClientCertificate |
boolean |
False |
Especifique true para negociar siempre el certificado de cliente en el nombre de host. El valor predeterminado es false. |
type |
Tipo de nombre de host. |
HostnameType
Tipo de nombre de host.
Nombre | Tipo | Description |
---|---|---|
DeveloperPortal |
string |
|
Management |
string |
|
Portal |
string |
|
Proxy |
string |
|
Scm |
string |
NatGatewayState
La propiedad se puede usar para habilitar nat Gateway para este servicio de API Management.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
Nat Gateway está deshabilitado para el servicio. |
Enabled |
string |
Nat Gateway está habilitado para el servicio. |
PlatformVersion
Versión de la plataforma de proceso que ejecuta el servicio.
Nombre | Tipo | Description |
---|---|---|
mtv1 |
string |
Plataforma que ejecuta el servicio en la plataforma Multi Tenant V1. |
stv1 |
string |
Plataforma que ejecuta el servicio en la plataforma single tenant V1. |
stv2 |
string |
Plataforma que ejecuta el servicio en la plataforma single tenant V2. |
undetermined |
string |
No se puede determinar la versión de la plataforma, ya que la plataforma de proceso no está implementada. |
PrivateEndpointServiceConnectionStatus
Estado de conexión del punto de conexión privado.
Nombre | Tipo | Description |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.
Nombre | Tipo | Description |
---|---|---|
actionsRequired |
string |
Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor. |
description |
string |
Motivo de aprobación o rechazo de la conexión. |
status |
Indica si el propietario del servicio ha aprobado, rechazado o quitado la conexión. |
PublicNetworkAccess
Si se permite o no el acceso al punto de conexión público para este servicio API Management. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". Si "Disabled", los puntos de conexión privados son el método de acceso exclusivo. El valor predeterminado es "Enabled"
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RemotePrivateEndpointConnectionWrapper
Recurso de conexión de punto de conexión privado remoto.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso de conexión de punto de conexión privado |
name |
string |
Nombre de conexión de punto de conexión privado |
properties.groupIds |
string[] |
Todos los identificadores de grupo. |
properties.privateEndpoint |
Recurso del punto de conexión privado. |
|
properties.privateLinkServiceConnectionState |
Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor. |
|
properties.provisioningState |
string |
Estado de aprovisionamiento del recurso de conexión de punto de conexión privado. |
type |
string |
Tipo de recurso de conexión de punto de conexión privado |
SkuType
Nombre de la SKU.
Nombre | Tipo | Description |
---|---|---|
Basic |
string |
SKU básica de Api Management. |
Consumption |
string |
SKU de consumo de Api Management. |
Developer |
string |
SKU para desarrolladores de Api Management. |
Isolated |
string |
SKU aislada de Api Management. |
Premium |
string |
SKU Premium de Api Management. |
Standard |
string |
SKU estándar de Api Management. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
UserIdentityProperties
Nombre | Tipo | Description |
---|---|---|
clientId |
string |
Identificador de cliente de la identidad asignada por el usuario. |
principalId |
string |
Identificador principal de la identidad asignada por el usuario. |
VirtualNetworkConfiguration
Configuración de una red virtual en la que se implementa API Management servicio.
Nombre | Tipo | Description |
---|---|---|
subnetResourceId |
string |
Identificador de recurso completo de una subred en una red virtual en la que se va a implementar el servicio API Management. |
subnetname |
string |
Nombre de la subred. |
vnetid |
string |
Identificador de red virtual. Normalmente, se trata de un GUID. Espere un GUID nulo de forma predeterminada. |
VirtualNetworkType
Tipo de VPN en el que se debe configurar API Management servicio. Ninguno (valor predeterminado) significa que el servicio API Management no forma parte de ninguna Virtual Network, external significa que la implementación de API Management se configura dentro de un Virtual Network que tiene un punto de conexión accesible desde Internet y significa internamente que API Management la implementación se configura dentro de un Virtual Network tener solo un punto de conexión accesible desde la intranet.
Nombre | Tipo | Description |
---|---|---|
External |
string |
El servicio forma parte de Virtual Network y es accesible desde Internet. |
Internal |
string |
El servicio forma parte de Virtual Network y solo es accesible desde dentro de la red virtual. |
None |
string |
El servicio no forma parte de ninguna Virtual Network. |