Certificates - Create Or Update

Usługa:: App Service

Wersja interfejsu API:: 2025-05-01

Opis tworzenia lub aktualizowania certyfikatu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
name	path	True	string	Nazwa certyfikatu.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
kind		string	Rodzaj zasobu. Jeśli zasób jest aplikacją, możesz zapoznać się z https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, aby uzyskać szczegółowe informacje o obsługiwanych wartościach dla rodzaju.
properties.canonicalName		string	CNAME certyfikatu do wystawienia za pośrednictwem bezpłatnego certyfikatu
properties.domainValidationMethod		string	Metoda weryfikacji domeny dla bezpłatnego certyfikatu
properties.hostNames		string[]	Nazwy hostów, do których ma zastosowanie certyfikat.
properties.keyVaultId		string (arm-id)	Identyfikator zasobu Csm usługi Azure Key Vault.
properties.keyVaultSecretName		string	Nazwa wpisu tajnego usługi Azure Key Vault.
properties.password		string	Hasło certyfikatu.
properties.pfxBlob		string (byte)	Obiekt blob Pfx.
properties.serverFarmId		string (arm-id)	Identyfikator zasobu skojarzonego planu App Service.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Certificate	Aktualizacja zasobu "Certyfikat" zakończyła się sukcesem
Other Status Codes	DefaultErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create Or Update Certificate

Przykładowe żądanie

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

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


import com.azure.resourcemanager.appservice.fluent.models.CertificateInner;
import java.util.Arrays;

/**
 * Samples for Certificates CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/CreateOrUpdateCertificate.json
     */
    /**
     * Sample code: Create Or Update Certificate.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void createOrUpdateCertificate(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getCertificates().createOrUpdateWithResponse(
            "testrg123", "testc6282", new CertificateInner().withLocation("East US")
                .withPassword("fakeTokenPlaceholder").withHostNames(Arrays.asList("ServerCert")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/CreateOrUpdateCertificate.json
func ExampleCertificatesClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewCertificatesClient().CreateOrUpdate(ctx, "testrg123", "testc6282", armappservice.AppCertificate{
		Location: to.Ptr("East US"),
		Properties: &armappservice.AppCertificateProperties{
			HostNames: []*string{
				to.Ptr("ServerCert"),
			},
			Password: to.Ptr("<password>"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.CertificatesClientCreateOrUpdateResponse{
	// 	AppCertificate: &armappservice.AppCertificate{
	// 		Name: to.Ptr("testc6282"),
	// 		Type: to.Ptr("Microsoft.Web/certificates"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappservice.AppCertificateProperties{
	// 			ExpirationDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2039-12-31T23:59:59+00:00"); return t}()),
	// 			FriendlyName: to.Ptr(""),
	// 			HostNames: []*string{
	// 				to.Ptr("ServerCert"),
	// 			},
	// 			IssueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-11-12T23:40:25+00:00"); return t}()),
	// 			Issuer: to.Ptr("CACert"),
	// 			SubjectName: to.Ptr("ServerCert"),
	// 			Thumbprint: to.Ptr("FE703D7411A44163B6D32B3AD9B03E175886EBFE"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwa	Opis
Certificate	Certyfikat SSL dla aplikacji.
createdByType	Typ tożsamości, która utworzyła zasób.
DefaultErrorResponse	Odpowiedź na błąd usługi App Service.
DefaultErrorResponseError	Model błędu.
DefaultErrorResponseErrorDetailsItem	Szczegółowe błędy.
HostingEnvironmentProfile	Specyfikacja App Service Environment do użycia dla tego zasobu.
KeyVaultSecretStatus	Stan klucza tajnego Key Vault.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Certificate

Objekt

Certyfikat SSL dla aplikacji.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Rodzaj zasobu. Jeśli zasób jest aplikacją, możesz zapoznać się z https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, aby uzyskać szczegółowe informacje o obsługiwanych wartościach dla rodzaju.
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.canonicalName	string	CNAME certyfikatu do wystawienia za pośrednictwem bezpłatnego certyfikatu
properties.cerBlob	string (byte)	Nieprzetworzone bajty pliku .cer
properties.domainValidationMethod	string	Metoda weryfikacji domeny dla bezpłatnego certyfikatu
properties.expirationDate	string (date-time)	Data wygaśnięcia certyfikatu.
properties.friendlyName	string	Przyjazna nazwa certyfikatu.
properties.hostNames	string[]	Nazwy hostów, do których ma zastosowanie certyfikat.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specyfikacja App Service Environment do użycia dla certyfikatu.
properties.issueDate	string (date-time)	Data wystawienia certyfikatu.
properties.issuer	string	Wystawca certyfikatu.
properties.keyVaultId	string (arm-id)	Identyfikator zasobu Csm usługi Azure Key Vault.
properties.keyVaultSecretName	string	Nazwa wpisu tajnego usługi Azure Key Vault.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Stan klucza tajnego Key Vault.
properties.password	string	Hasło certyfikatu.
properties.pfxBlob	string (byte)	Obiekt blob Pfx.
properties.publicKeyHash	string	Skrót klucza publicznego.
properties.selfLink	string	Łącze własne.
properties.serverFarmId	string (arm-id)	Identyfikator zasobu skojarzonego planu App Service.
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?.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objekt

Odpowiedź na błąd usługi App Service.

Nazwa	Typ	Opis
error	DefaultErrorResponseError	Model błędu.

DefaultErrorResponseError

Objekt

Model błędu.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowej identyfikacji błędu.
details	DefaultErrorResponseErrorDetailsItem[]	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.

DefaultErrorResponseErrorDetailsItem

Objekt

Szczegółowe błędy.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowej identyfikacji 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

Objekt

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

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

KeyVaultSecretStatus

Wyliczenie

Stan klucza tajnego Key Vault.

Wartość	Opis
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

Certificates - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Create Or Update Certificate

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData