Certificates - Create Or Update

Service:: App Service

API-versie:: 2025-05-01

Beschrijving voor Een certificaat maken of bijwerken.

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

URI-parameters

Name	In	Vereist	Type	Description
name	path	True	string	Naam van het certificaat.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
kind		string	Soort resource. Als de resource een app is, kunt u verwijzen naar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference voor meer informatie over ondersteunde waarden voor soort.
properties.canonicalName		string	CNAME van het certificaat dat moet worden uitgegeven via een gratis certificaat
properties.domainValidationMethod		string	Methode van domeinvalidatie voor gratis certificaat
properties.hostNames		string[]	Hostnamen waarop het certificaat van toepassing is.
properties.keyVaultId		string (arm-id)	Azure Key Vault CSM resource-id.
properties.keyVaultSecretName		string	Naam van azure Key Vault-geheim.
properties.password		string	Certificaatwachtwoord.
properties.pfxBlob		string (byte)	Pfx-blob.
properties.serverFarmId		string (arm-id)	Resource-id van het gekoppelde App Service-abonnement.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Certificate	De updateoperatie van de bron 'Certificate' is geslaagd
Other Status Codes	DefaultErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create Or Update Certificate

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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"
  }
}

Definities

Name	Description
Certificate	SSL-certificaat voor een app.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DefaultErrorResponse	Foutreactie van App Service.
DefaultErrorResponseError	Foutmodel.
DefaultErrorResponseErrorDetailsItem	Gedetailleerde fouten.
HostingEnvironmentProfile	Specificatie voor een App Service-omgeving die voor deze resource moet worden gebruikt.
KeyVaultSecretStatus	Status van het geheim van de sleutelkluis.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Certificate

Object

SSL-certificaat voor een app.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
kind	string	Soort resource. Als de resource een app is, kunt u verwijzen naar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference voor meer informatie over ondersteunde waarden voor soort.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.canonicalName	string	CNAME van het certificaat dat moet worden uitgegeven via een gratis certificaat
properties.cerBlob	string (byte)	Onbewerkte bytes van .cer-bestand
properties.domainValidationMethod	string	Methode van domeinvalidatie voor gratis certificaat
properties.expirationDate	string (date-time)	Vervaldatum van certificaat.
properties.friendlyName	string	Vriendelijke naam van het certificaat.
properties.hostNames	string[]	Hostnamen waarop het certificaat van toepassing is.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specificatie voor de App Service Environment die moet worden gebruikt voor het certificaat.
properties.issueDate	string (date-time)	Datum van certificaatuitgifte.
properties.issuer	string	Certificaatverlener.
properties.keyVaultId	string (arm-id)	Azure Key Vault CSM resource-id.
properties.keyVaultSecretName	string	Naam van azure Key Vault-geheim.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Status van het geheim van de sleutelkluis.
properties.password	string	Certificaatwachtwoord.
properties.pfxBlob	string (byte)	Pfx-blob.
properties.publicKeyHash	string	Hash van openbare sleutel.
properties.selfLink	string	Zelf koppelen.
properties.serverFarmId	string (arm-id)	Resource-id van het gekoppelde App Service-abonnement.
properties.siteName	string	Naam van app.
properties.subjectName	string	Onderwerpnaam van het certificaat.
properties.thumbprint	string	Vingerafdruk van certificaat.
properties.valid	boolean	Is het certificaat geldig?.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijv. "Microsoft.Compute/virtualMachines" of "Microsoft.Storage/storageAccounts"

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Object

Foutreactie van App Service.

Name	Type	Description
error	DefaultErrorResponseError	Foutmodel.

DefaultErrorResponseError

Object

Foutmodel.

Name	Type	Description
code	string	Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.
details	DefaultErrorResponseErrorDetailsItem[]	Gedetailleerde fouten.
innererror	string	Meer informatie om fouten op te sporen.
message	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.
target	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

DefaultErrorResponseErrorDetailsItem

Object

Gedetailleerde fouten.

Name	Type	Description
code	string	Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.
message	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.
target	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

HostingEnvironmentProfile

Object

Specificatie voor een App Service-omgeving die voor deze resource moet worden gebruikt.

Name	Type	Description
id	string	Resource-id van de App Service-omgeving.
name	string	Naam van de App Service-omgeving.
type	string	Resourcetype van de App Service Environment.

KeyVaultSecretStatus

Opsomming

Status van het geheim van de sleutelkluis.

Waarde	Description
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Certificates - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Create Or Update Certificate

Voorbeeldaanvraag

Voorbeeldrespons

Definities

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData