App Service Certificate Orders - Validate Purchase Information

Referencia

Service:: App Service

API Version:: 2023-12-01

Descripción para validar la información de un pedido de certificado.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation?api-version=2023-12-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string	Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-0000-0000-0000-000000000000000).
api-version	query	True	string	Versión de la API

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación del recurso.
properties.productType	True	CertificateProductType	Tipo de producto de certificado.
kind		string	Tipo de recurso.
properties.autoRenew		boolean	`true` si el certificado debe renovarse automáticamente cuando expire; de lo contrario, `false`.
properties.certificates		<string, AppServiceCertificate>	Estado del secreto de Key Vault.
properties.csr		string	Última CSR que se creó para este pedido.
properties.distinguishedName		string	Nombre distintivo del certificado.
properties.keySize		integer	Tamaño de clave de certificado.
properties.validityInYears		integer	Duración en años (debe ser 1).
tags		object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
204 No Content		Ningún contenido
Other Status Codes	DefaultErrorResponse	App Service respuesta de error.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Validate App Service Certificate purchase information by subscription

Sample Request

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation?api-version=2023-12-01

{
  "location": "Global",
  "properties": {
    "certificates": {
      "SampleCertName1": {
        "keyVaultId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/microsoft.keyvault/vaults/SamplevaultName",
        "keyVaultSecretName": "SampleSecretName1"
      },
      "SampleCertName2": {
        "keyVaultId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/microsoft.keyvault/vaults/SamplevaultName",
        "keyVaultSecretName": "SampleSecretName2"
      }
    },
    "distinguishedName": "CN=SampleCustomDomain.com",
    "validityInYears": 2,
    "keySize": 2048,
    "productType": "StandardDomainValidatedSsl",
    "autoRenew": true
  }
}

Sample Response

Status code:: 204

Definiciones

Nombre	Description
AppServiceCertificate	Key Vault contenedor de un certificado adquirido a través de Azure.
AppServiceCertificateOrder	Pedido de compra del certificado SSL.
CertificateDetails	Detalles del certificado SSL.
CertificateOrderContact
CertificateOrderStatus	Estado actual del pedido.
CertificateProductType	Tipo de producto de certificado.
DefaultErrorResponse	App Service respuesta de error.
Details
Error	Modelo de error.
KeyVaultSecretStatus	Estado del secreto de Key Vault.
ProvisioningState	Estado del pedido de certificado.
ResourceNotRenewableReason	Motivos por los que App Service certificado no es renovable en el momento actual.

AppServiceCertificate

Key Vault contenedor de un certificado adquirido a través de Azure.

Nombre	Tipo	Description
keyVaultId	string	Key Vault id. de recurso.
keyVaultSecretName	string	Key Vault nombre del secreto.
provisioningState	KeyVaultSecretStatus	Estado del secreto de Key Vault.

AppServiceCertificateOrder

Pedido de compra del certificado SSL.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso.
kind	string		Tipo de recurso.
location	string		Ubicación del recurso.
name	string		Nombre del recurso.
properties.appServiceCertificateNotRenewableReasons	ResourceNotRenewableReason[]		Motivos por los que App Service certificado no es renovable en el momento actual.
properties.autoRenew	boolean	True	`true` si el certificado debe renovarse automáticamente cuando expire; de lo contrario, `false`.
properties.certificates	<string, AppServiceCertificate>		Estado del secreto de Key Vault.
properties.contact	CertificateOrderContact		Información de contacto
properties.csr	string		Última CSR que se creó para este pedido.
properties.distinguishedName	string		Nombre distintivo del certificado.
properties.domainVerificationToken	string		Token de comprobación de dominio.
properties.expirationTime	string		Hora de expiración del certificado.
properties.intermediate	CertificateDetails		Certificado intermedio.
properties.isPrivateKeyExternal	boolean		`true` si la clave privada es externa; de lo contrario, `false`.
properties.keySize	integer	2048	Tamaño de clave de certificado.
properties.lastCertificateIssuanceTime	string		Hora de la última emisión del certificado.
properties.nextAutoRenewalTimeStamp	string		Marca de tiempo en la que el certificado se renovaría automáticamente a continuación
properties.productType	CertificateProductType		Tipo de producto de certificado.
properties.provisioningState	ProvisioningState		Estado del pedido de certificado.
properties.root	CertificateDetails		Certificado raíz.
properties.serialNumber	string		Número de serie actual del certificado.
properties.signedCertificate	CertificateDetails		Certificado firmado.
properties.status	CertificateOrderStatus		Estado actual del pedido.
properties.validityInYears	integer	1	Duración en años (debe ser 1).
tags	object		Etiquetas del recurso.
type	string		Tipo de recurso.

CertificateDetails

Detalles del certificado SSL.

Nombre	Tipo	Description
issuer	string	Emisor de certificados.
notAfter	string	El certificado de fecha es válido para.
notBefore	string	El certificado de fecha es válido.
rawData	string	Datos de certificado sin procesar.
serialNumber	string	Número de serie del certificado.
signatureAlgorithm	string	Algoritmo de firma de certificado.
subject	string	Asunto del certificado.
thumbprint	string	Huella digital del certificado.
version	integer	Versión del certificado.

CertificateOrderContact

Nombre	Tipo	Description
email	string
nameFirst	string
nameLast	string
phone	string

CertificateOrderStatus

Estado actual del pedido.

Nombre	Tipo	Description
Canceled	string
Denied	string
Expired	string
Issued	string
NotSubmitted	string
PendingRekey	string
Pendingissuance	string
Pendingrevocation	string
Revoked	string
Unused	string

CertificateProductType

Tipo de producto de certificado.

Nombre	Tipo	Description
StandardDomainValidatedSsl	string
StandardDomainValidatedWildCardSsl	string

DefaultErrorResponse

App Service respuesta de error.

Nombre	Tipo	Description
error	Error	Modelo de error.

Details

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

Error

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
details	Details[]	Errores detallados.
innererror	string	Más información para depurar el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

KeyVaultSecretStatus

Estado del secreto de Key Vault.

Nombre	Tipo	Description
AzureServiceUnauthorizedToAccessKeyVault	string
CertificateOrderFailed	string
ExternalPrivateKey	string
Initialized	string
KeyVaultDoesNotExist	string
KeyVaultSecretDoesNotExist	string
OperationNotPermittedOnKeyVault	string
Succeeded	string
Unknown	string
UnknownError	string
WaitingOnCertificateOrder	string

ProvisioningState

Estado del pedido de certificado.

Nombre	Tipo	Description
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ResourceNotRenewableReason

Motivos por los que App Service certificado no es renovable en el momento actual.

Nombre	Tipo	Description
ExpirationNotInRenewalTimeRange	string
RegistrationStatusNotSupportedForRenewal	string
SubscriptionNotActive	string

Share via