Certificates - Create Or Update

Odwołanie

Service:: App Service

API Version:: 2023-12-01

Opis Twórca lub aktualizacji certyfikatu.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/certificates/{name}?api-version=2023-12-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
name	path	True	string	Nazwa certyfikatu.
resourceGroupName	path	True	string	Nazwa grupy zasobów, do której należy zasób. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Azure. Jest to ciąg w formacie GUID (np. 00000000-0000-0000-0000-0000-000000000000).
api-version	query	True	string	Wersja interfejsu API

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja zasobu.
kind		string	Rodzaj zasobu.
properties.canonicalName		string	CNAME certyfikatu, który ma zostać wystawiony za pośrednictwem bezpłatnego certyfikatu
properties.domainValidationMethod		string	Metoda weryfikacji domeny dla bezpłatnego certyfikatu
properties.hostNames		string[]	Nazwy hostów, których dotyczy certyfikat.
properties.keyVaultId		string	Key Vault identyfikator zasobu Csm.
properties.keyVaultSecretName		string	Key Vault nazwę wpisu tajnego.
properties.password		string	Hasło certyfikatu.
properties.pfxBlob		string	Obiekt blob Pfx.
properties.serverFarmId		string	Identyfikator zasobu skojarzonego planu App Service sformatowany jako: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Certificate	OK.
Other Status Codes	DefaultErrorResponse	App Service odpowiedź na błąd.

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

Create Or Update Certificate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282?api-version=2023-12-01

{
  "location": "East US",
  "properties": {
    "hostNames": [
      "ServerCert"
    ],
    "password": "<password>"
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282",
  "name": "testc6282",
  "type": "Microsoft.Web/certificates",
  "location": "East US",
  "properties": {
    "friendlyName": "",
    "subjectName": "ServerCert",
    "hostNames": [
      "ServerCert"
    ],
    "issuer": "CACert",
    "issueDate": "2015-11-12T23:40:25+00:00",
    "expirationDate": "2039-12-31T23:59:59+00:00",
    "thumbprint": "FE703D7411A44163B6D32B3AD9B03E175886EBFE"
  }
}

Definicje

Nazwa	Opis
Certificate	Certyfikat SSL dla aplikacji.
DefaultErrorResponse	App Service odpowiedź na błąd.
Details
Error	Model błędu.
HostingEnvironmentProfile	Specyfikacja App Service Environment do użycia dla tego zasobu.
KeyVaultSecretStatus	Stan wpisu tajnego Key Vault.

Certificate

Certyfikat SSL dla aplikacji.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
kind	string	Rodzaj zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.canonicalName	string	CNAME certyfikatu, który ma zostać wystawiony za pośrednictwem bezpłatnego certyfikatu
properties.cerBlob	string	Nieprzetworzone bajty pliku .cer
properties.domainValidationMethod	string	Metoda weryfikacji domeny dla bezpłatnego certyfikatu
properties.expirationDate	string	Data wygaśnięcia certyfikatu.
properties.friendlyName	string	Przyjazna nazwa certyfikatu.
properties.hostNames	string[]	Nazwy hostów, których dotyczy certyfikat.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specyfikacja App Service Environment do użycia dla certyfikatu.
properties.issueDate	string	Data wystawienia certyfikatu.
properties.issuer	string	Wystawca certyfikatu.
properties.keyVaultId	string	Key Vault identyfikator zasobu Csm.
properties.keyVaultSecretName	string	Key Vault nazwę wpisu tajnego.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Stan wpisu tajnego Key Vault.
properties.password	string	Hasło certyfikatu.
properties.pfxBlob	string	Obiekt blob Pfx.
properties.publicKeyHash	string	Skrót klucza publicznego.
properties.selfLink	string	Łącze samodzielne.
properties.serverFarmId	string	Identyfikator zasobu skojarzonego planu App Service sformatowany jako: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteName	string	Nazwa aplikacji.
properties.subjectName	string	Nazwa podmiotu certyfikatu.
properties.thumbprint	string	Odcisk palca certyfikatu.
properties.valid	boolean	Czy certyfikat jest ważny?.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

DefaultErrorResponse

App Service odpowiedź na błąd.

Nazwa	Typ	Opis
error	Error	Model błędu.

Details

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg w celu programowego identyfikowania błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

Error

Model błędu.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg w celu programowego identyfikowania błędu.
details	Details[]	Szczegółowe błędy.
innererror	string	Więcej informacji na temat debugowania błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

HostingEnvironmentProfile

Specyfikacja App Service Environment do użycia dla tego zasobu.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu App Service Environment.
name	string	Nazwa App Service Environment.
type	string	Typ zasobu App Service Environment.

KeyVaultSecretStatus

Stan wpisu tajnego Key Vault.

Nazwa	Typ	Opis
AzureServiceUnauthorizedToAccessKeyVault	string
CertificateOrderFailed	string
ExternalPrivateKey	string
Initialized	string
KeyVaultDoesNotExist	string
KeyVaultSecretDoesNotExist	string
OperationNotPermittedOnKeyVault	string
Succeeded	string
Unknown	string
UnknownError	string
WaitingOnCertificateOrder	string