Domains - Transfer Out

Référence

Service:: App Service

API Version:: 2023-01-01

Transférer un domaine vers un autre bureau d’enregistrement

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/transferOut?api-version=2023-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
domainName	path	True	string	Nom du domaine.
resourceGroupName	path	True	string	Nom du groupe de ressources auquel appartient la ressource. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	Votre ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 000000-0000-0000-0000-000000000000000).
api-version	query	True	string	Version d'API

Réponses

Nom	Type	Description
200 OK	Domain	Le code de transfert a été retourné pour transférer le domaine vers un autre bureau d’enregistrement.
400 Bad Request		Le domaine n’existe pas dans la base de données Azure
Other Status Codes	DefaultErrorResponse	App Service réponse d’erreur.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Transfer out domain

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.DomainRegistration/domains/example.com/transferOut?api-version=2023-01-01


/**
 * Samples for Domains TransferOut.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/web/resource-manager/Microsoft.DomainRegistration/stable/2023-01-01/examples/TransferOutDomain.json
     */
    /**
     * Sample code: Transfer out domain.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void transferOutDomain(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.webApps().manager().serviceClient().getDomains().transferOutWithResponse("testrg123", "example.com",
            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

from azure.identity import DefaultAzureCredential
from azure.mgmt.web import WebSiteManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-web
# USAGE
    python transfer_out_domain.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = WebSiteManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    )

    response = client.domains.transfer_out(
        resource_group_name="testrg123",
        domain_name="example.com",
    )
    print(response)


# x-ms-original-file: specification/web/resource-manager/Microsoft.DomainRegistration/stable/2023-01-01/examples/TransferOutDomain.json
if __name__ == "__main__":
    main()

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/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/738ab25fe76324897f273645906d4a0415068a6c/specification/web/resource-manager/Microsoft.DomainRegistration/stable/2023-01-01/examples/TransferOutDomain.json
func ExampleDomainsClient_TransferOut() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewDomainsClient().TransferOut(ctx, "testrg123", "example.com", 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.Domain = armappservice.Domain{
	// 	Name: to.Ptr("example.com"),
	// 	Type: to.Ptr("Microsoft.DomainRegistration/domains"),
	// 	ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.DomainRegistration/domains/example.com"),
	// 	Location: to.Ptr("global"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armappservice.DomainProperties{
	// 		AuthCode: to.Ptr("exampleAuthCode"),
	// 		AutoRenew: to.Ptr(true),
	// 		Consent: &armappservice.DomainPurchaseConsent{
	// 			AgreedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-10T19:30:53.000Z"); return t}()),
	// 			AgreedBy: to.Ptr("192.0.2.1"),
	// 			AgreementKeys: []*string{
	// 				to.Ptr("agreementKey1")},
	// 			},
	// 			ContactAdmin: &armappservice.Contact{
	// 				AddressMailing: &armappservice.Address{
	// 					Address1: to.Ptr("3400 State St"),
	// 					City: to.Ptr("Chicago"),
	// 					Country: to.Ptr("United States"),
	// 					PostalCode: to.Ptr("67098"),
	// 					State: to.Ptr("IL"),
	// 				},
	// 				Email: to.Ptr("admin@email.com"),
	// 				Fax: to.Ptr("1-245-534-2242"),
	// 				JobTitle: to.Ptr("Admin"),
	// 				NameFirst: to.Ptr("John"),
	// 				NameLast: to.Ptr("Doe"),
	// 				NameMiddle: to.Ptr(""),
	// 				Organization: to.Ptr("Microsoft Inc."),
	// 				Phone: to.Ptr("1-245-534-2242"),
	// 			},
	// 			ContactBilling: &armappservice.Contact{
	// 				AddressMailing: &armappservice.Address{
	// 					Address1: to.Ptr("3400 State St"),
	// 					City: to.Ptr("Chicago"),
	// 					Country: to.Ptr("United States"),
	// 					PostalCode: to.Ptr("67098"),
	// 					State: to.Ptr("IL"),
	// 				},
	// 				Email: to.Ptr("billing@email.com"),
	// 				Fax: to.Ptr("1-245-534-2242"),
	// 				JobTitle: to.Ptr("Billing"),
	// 				NameFirst: to.Ptr("John"),
	// 				NameLast: to.Ptr("Doe"),
	// 				NameMiddle: to.Ptr(""),
	// 				Organization: to.Ptr("Microsoft Inc."),
	// 				Phone: to.Ptr("1-245-534-2242"),
	// 			},
	// 			ContactRegistrant: &armappservice.Contact{
	// 				AddressMailing: &armappservice.Address{
	// 					Address1: to.Ptr("3400 State St"),
	// 					City: to.Ptr("Chicago"),
	// 					Country: to.Ptr("United States"),
	// 					PostalCode: to.Ptr("67098"),
	// 					State: to.Ptr("IL"),
	// 				},
	// 				Email: to.Ptr("registrant@email.com"),
	// 				Fax: to.Ptr("1-245-534-2242"),
	// 				JobTitle: to.Ptr("Registrant"),
	// 				NameFirst: to.Ptr("John"),
	// 				NameLast: to.Ptr("Doe"),
	// 				NameMiddle: to.Ptr(""),
	// 				Organization: to.Ptr("Microsoft Inc."),
	// 				Phone: to.Ptr("1-245-534-2242"),
	// 			},
	// 			ContactTech: &armappservice.Contact{
	// 				AddressMailing: &armappservice.Address{
	// 					Address1: to.Ptr("3400 State St"),
	// 					City: to.Ptr("Chicago"),
	// 					Country: to.Ptr("United States"),
	// 					PostalCode: to.Ptr("67098"),
	// 					State: to.Ptr("IL"),
	// 				},
	// 				Email: to.Ptr("tech@email.com"),
	// 				Fax: to.Ptr("1-245-534-2242"),
	// 				JobTitle: to.Ptr("Tech"),
	// 				NameFirst: to.Ptr("John"),
	// 				NameLast: to.Ptr("Doe"),
	// 				NameMiddle: to.Ptr(""),
	// 				Organization: to.Ptr("Microsoft Inc."),
	// 				Phone: to.Ptr("1-245-534-2242"),
	// 			},
	// 			CreatedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-09-10T19:30:53.000Z"); return t}()),
	// 			DNSType: to.Ptr(armappservice.DNSTypeDefaultDomainRegistrarDNS),
	// 			DomainNotRenewableReasons: []*armappservice.ResourceNotRenewableReason{
	// 				to.Ptr(armappservice.ResourceNotRenewableReasonExpirationNotInRenewalTimeRange)},
	// 				ExpirationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-09-10T19:30:53.000Z"); return t}()),
	// 				ManagedHostNames: []*armappservice.HostName{
	// 				},
	// 				NameServers: []*string{
	// 					to.Ptr("ns01.ote.domaincontrol.com"),
	// 					to.Ptr("ns02.ote.domaincontrol.com")},
	// 					Privacy: to.Ptr(false),
	// 					ProvisioningState: to.Ptr(armappservice.ProvisioningStateSucceeded),
	// 					ReadyForDNSRecordManagement: to.Ptr(true),
	// 					RegistrationStatus: to.Ptr(armappservice.DomainStatusActive),
	// 				},
	// 			}
}

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

const { WebSiteManagementClient } = require("@azure/arm-appservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Transfer out domain to another registrar
 *
 * @summary Transfer out domain to another registrar
 * x-ms-original-file: specification/web/resource-manager/Microsoft.DomainRegistration/stable/2023-01-01/examples/TransferOutDomain.json
 */
async function transferOutDomain() {
  const subscriptionId =
    process.env["APPSERVICE_SUBSCRIPTION_ID"] || "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const resourceGroupName = process.env["APPSERVICE_RESOURCE_GROUP"] || "testrg123";
  const domainName = "example.com";
  const credential = new DefaultAzureCredential();
  const client = new WebSiteManagementClient(credential, subscriptionId);
  const result = await client.domains.transferOut(resourceGroupName, domainName);
  console.log(result);
}

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.DomainRegistration/domains/example.com",
  "name": "example.com",
  "type": "Microsoft.DomainRegistration/domains",
  "location": "global",
  "tags": {},
  "properties": {
    "authCode": "exampleAuthCode",
    "registrationStatus": "Active",
    "provisioningState": "Succeeded",
    "nameServers": [
      "ns01.ote.domaincontrol.com",
      "ns02.ote.domaincontrol.com"
    ],
    "privacy": false,
    "createdTime": "2021-09-10T19:30:53Z",
    "expirationTime": "2022-09-10T19:30:53Z",
    "autoRenew": true,
    "readyForDnsRecordManagement": true,
    "managedHostNames": [],
    "domainNotRenewableReasons": [
      "ExpirationNotInRenewalTimeRange"
    ],
    "dnsType": "DefaultDomainRegistrarDns",
    "consent": {
      "agreementKeys": [
        "agreementKey1"
      ],
      "agreedBy": "192.0.2.1",
      "agreedAt": "2021-09-10T19:30:53Z"
    },
    "contactTech": {
      "email": "tech@email.com",
      "fax": "1-245-534-2242",
      "nameFirst": "John",
      "nameLast": "Doe",
      "nameMiddle": "",
      "jobTitle": "Tech",
      "organization": "Microsoft Inc.",
      "phone": "1-245-534-2242",
      "addressMailing": {
        "address1": "3400 State St",
        "city": "Chicago",
        "state": "IL",
        "country": "United States",
        "postalCode": "67098"
      }
    },
    "contactBilling": {
      "email": "billing@email.com",
      "fax": "1-245-534-2242",
      "nameFirst": "John",
      "nameLast": "Doe",
      "nameMiddle": "",
      "jobTitle": "Billing",
      "organization": "Microsoft Inc.",
      "phone": "1-245-534-2242",
      "addressMailing": {
        "address1": "3400 State St",
        "city": "Chicago",
        "state": "IL",
        "country": "United States",
        "postalCode": "67098"
      }
    },
    "contactAdmin": {
      "email": "admin@email.com",
      "fax": "1-245-534-2242",
      "nameFirst": "John",
      "nameLast": "Doe",
      "nameMiddle": "",
      "jobTitle": "Admin",
      "organization": "Microsoft Inc.",
      "phone": "1-245-534-2242",
      "addressMailing": {
        "address1": "3400 State St",
        "city": "Chicago",
        "state": "IL",
        "country": "United States",
        "postalCode": "67098"
      }
    },
    "contactRegistrant": {
      "email": "registrant@email.com",
      "fax": "1-245-534-2242",
      "nameFirst": "John",
      "nameLast": "Doe",
      "nameMiddle": "",
      "jobTitle": "Registrant",
      "organization": "Microsoft Inc.",
      "phone": "1-245-534-2242",
      "addressMailing": {
        "address1": "3400 State St",
        "city": "Chicago",
        "state": "IL",
        "country": "United States",
        "postalCode": "67098"
      }
    }
  }
}

Status code:: 400

Définitions

Nom	Description
Address	Informations d’adresse pour l’inscription de domaine.
AzureResourceType	Type de la ressource Azure à laquelle le nom d’hôte est affecté.
Contact	Coordonnées pour l’inscription de domaine. Si l’option « Confidentialité du domaine » n’est pas sélectionnée, les informations de contact sont mises à la disposition du public via les répertoires Whois conformément aux exigences de l’ICANN.
CustomHostNameDnsRecordType	Type de l’enregistrement DNS.
DefaultErrorResponse	App Service réponse d’erreur.
Details
DnsType	Type DNS actuel
Domain	Informations sur un domaine.
DomainPurchaseConsent	Objet de consentement d’achat de domaine, représentant l’acceptation des contrats juridiques applicables.
DomainStatus	status d’inscription de domaine.
Error	Modèle d’erreur.
HostName	Détails d’un nom d’hôte dérivé d’un domaine.
HostNameType	Type du nom d’hôte.
ProvisioningState	État de l’approvisionnement de domaine.
ResourceNotRenewableReason	Raisons pour lesquelles le domaine n’est pas renouvelable.

Address

Informations d’adresse pour l’inscription de domaine.

Nom	Type	Description
address1	string	Première ligne d’une adresse.
address2	string	Deuxième ligne de l’adresse. facultatif.
city	string	Ville de l’adresse.
country	string	Pays de l’adresse.
postalCode	string	Code postal de l’adresse.
state	string	État ou province de l’adresse.

AzureResourceType

Type de la ressource Azure à laquelle le nom d’hôte est affecté.

Nom	Type	Description
TrafficManager	string
Website	string

Contact

Coordonnées pour l’inscription de domaine. Si l’option « Confidentialité du domaine » n’est pas sélectionnée, les informations de contact sont mises à la disposition du public via les répertoires Whois conformément aux exigences de l’ICANN.

Nom	Type	Description
addressMailing	Address	Adresse postale.
email	string	Adresse e-mail.
fax	string	Numéro de télécopie.
jobTitle	string	poste occupé.
nameFirst	string	Prénom.
nameLast	string	Nom.
nameMiddle	string	Deuxième prénom.
organization	string	Le contact de l’organisation appartient à.
phone	string	Numéro de téléphone.

CustomHostNameDnsRecordType

Type de l’enregistrement DNS.

Nom	Type	Description
A	string
CName	string

DefaultErrorResponse

App Service réponse d’erreur.

Nom	Type	Description
error	Error	Modèle d’erreur.

Details

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

DnsType

Type DNS actuel

Nom	Type	Description
AzureDns	string
DefaultDomainRegistrarDns	string

Domain

Informations sur un domaine.

Nom	Type	Valeur par défaut	Description
id	string		ID de ressource.
kind	string		Type de ressource.
location	string		Emplacement de la ressource.
name	string		Nom de la ressource.
properties.authCode	string
properties.autoRenew	boolean	True	`true` si le domaine doit être renouvelé automatiquement ; sinon, `false`.
properties.consent	DomainPurchaseConsent		Consentement légal.
properties.contactAdmin	Contact		Contact administratif.
properties.contactBilling	Contact		Contact de facturation.
properties.contactRegistrant	Contact		Contact de l’inscrit.
properties.contactTech	Contact		Contact technique.
properties.createdTime	string		Horodatage de création de domaine.
properties.dnsType	DnsType		Type DNS actuel
properties.dnsZoneId	string		Zone Azure DNS à utiliser
properties.domainNotRenewableReasons	ResourceNotRenewableReason[]		Raisons pour lesquelles le domaine n’est pas renouvelable.
properties.expirationTime	string		Horodatage d’expiration du domaine.
properties.lastRenewedTime	string		Horodatage lors du dernier renouvellement du domaine.
properties.managedHostNames	HostName[]		Tous les noms d’hôte dérivés du domaine et affectés aux ressources Azure.
properties.nameServers	string[]		Serveurs de noms.
properties.privacy	boolean		`true` si la confidentialité du domaine est activée pour ce domaine ; sinon, `false`.
properties.provisioningState	ProvisioningState		État de l’approvisionnement de domaine.
properties.readyForDnsRecordManagement	boolean		`true`si Azure peut affecter ce domaine à App Service applications ; sinon, `false`. Cette valeur est `true` si l’inscription de domaine status est active et qu’elle est hébergée sur des serveurs de noms auxquels Azure a accès par programmation.
properties.registrationStatus	DomainStatus		status d’inscription de domaine.
properties.targetDnsType	DnsType		Type DNS cible (utilisé pour la migration)
tags	object		Balises de ressource.
type	string		Type de ressource.

DomainPurchaseConsent

Objet de consentement d’achat de domaine, représentant l’acceptation des contrats juridiques applicables.

Nom	Type	Description
agreedAt	string	Horodatage lorsque les contrats ont été acceptés.
agreedBy	string	Adresse IP du client.
agreementKeys	string[]	Liste des clés des contrats juridiques applicables. Cette liste peut être récupérée à l’aide de l’API ListLegalAgreements sous `TopLevelDomain` ressource.

DomainStatus

status d’inscription de domaine.

Nom	Type	Description
Active	string
Awaiting	string
Cancelled	string
Confiscated	string
Disabled	string
Excluded	string
Expired	string
Failed	string
Held	string
JsonConverterFailed	string
Locked	string
Parked	string
Pending	string
Reserved	string
Reverted	string
Suspended	string
Transferred	string
Unknown	string
Unlocked	string
Unparked	string
Updated	string

Error

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	Details[]	Erreurs détaillées.
innererror	string	Plus d’informations sur l’erreur de débogage.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

HostName

Détails d’un nom d’hôte dérivé d’un domaine.

Nom	Type	Description
azureResourceName	string	Nom de la ressource Azure à laquelle le nom d’hôte est affecté. S’il est attribué à un Traffic Manager, il s’agit du nom Traffic Manager sinon, il s’agit du nom de l’application.
azureResourceType	AzureResourceType	Type de la ressource Azure à laquelle le nom d’hôte est affecté.
customHostNameDnsRecordType	CustomHostNameDnsRecordType	Type de l’enregistrement DNS.
hostNameType	HostNameType	Type du nom d’hôte.
name	string	Nom du nom d’hôte.
siteNames	string[]	Liste des applications auxquelles le nom d’hôte est attribué. Cette liste n’aura plusieurs applications que si le nom d’hôte pointe vers un Traffic Manager.

HostNameType

Type du nom d’hôte.

Nom	Type	Description
Managed	string
Verified	string

ProvisioningState

État de l’approvisionnement de domaine.

Nom	Type	Description
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ResourceNotRenewableReason

Raisons pour lesquelles le domaine n’est pas renouvelable.

Nom	Type	Description
ExpirationNotInRenewalTimeRange	string
RegistrationStatusNotSupportedForRenewal	string
SubscriptionNotActive	string

Domains - Transfer Out

Paramètres URI

Réponses

Sécurité

azure_auth

Scopes

Exemples

Transfer out domain

Sample Request

Sample Response

Définitions

Address

AzureResourceType

Contact

CustomHostNameDnsRecordType

DefaultErrorResponse

Details

DnsType

Domain

DomainPurchaseConsent

DomainStatus

Error

HostName

HostNameType

ProvisioningState

ResourceNotRenewableReason

Ressources supplémentaires