Certificates - Create Or Update

Opis tworzenia lub aktualizowania certyfikatu.

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

Parametry identyfikatora URI

Name In Required Type Description
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-0000000000000).

api-version
query True
  • string

Wersja interfejsu API

Treść żądania

Name Required Type Description
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

Name Type Description
200 OK

OK.

Other Status Codes

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

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

Create Or Update Certificate

Sample Request

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

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

Sample Response

{
  "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

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.

Name Type Description
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

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

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.

Name Type Description
error

Model błędu.

Details

Name Type Description
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.

Name Type Description
code
  • string

Ustandaryzowany ciąg w celu programowego identyfikowania błędu.

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.

Name Type Description
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.

Name Type Description
AzureServiceUnauthorizedToAccessKeyVault
  • string
CertificateOrderFailed
  • string
ExternalPrivateKey
  • string
Initialized
  • string
KeyVaultDoesNotExist
  • string
KeyVaultSecretDoesNotExist
  • string
OperationNotPermittedOnKeyVault
  • string
Succeeded
  • string
Unknown
  • string
UnknownError
  • string
WaitingOnCertificateOrder
  • string