Crear cloudPcOnPremisesConnectionCreate cloudPcOnPremisesConnection

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Crea un nuevo objeto cloudPcOnPremisesConnection para aprovisionar equipos en la nube.Create a new cloudPcOnPremisesConnection object for provisioning cloud PCs.

Importante

La API de PC en la nube está en versión preliminar y actualmente solo está disponible para un grupo selecto de clientes.The cloud PC API is in preview and is currently available only to a select group of customers.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) CloudPC. ReadWrite. AllCloudPC.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP request

POST /deviceManagement/virtualEndpoint/onPremisesConnections

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto cloudPcOnPremisesConnection.In the request body, supply a JSON representation of the cloudPcOnPremisesConnection object.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto cloudPcOnPremisesConnection.The following table shows the properties that are required when you create the cloudPcOnPremisesConnection.

PropiedadProperty TipoType DescripciónDescription
displayNamedisplayName StringString Nombre para mostrar de la conexión local.The display name for the on-premises connection.
subscriptionIdsubscriptionId StringString El identificador de la suscripción de Azure de destino que está asociada a su espacio empresarial.The ID of the target Azure subscription that’s associated with your tenant.
adDomainNameadDomainName StringString El nombre de dominio completo (FQDN) del dominio de Active Directory al que desea unirse.The fully qualified domain name (FQDN) of the Active Directory domain you want to join.
adDomainUsernameadDomainUsername StringString El nombre de usuario de una cuenta de Active Directory (cuenta de usuario o de servicio) que tiene permisos para crear objetos de equipo en Active Directory.The username of an Active Directory account (user or service account) that has permissions to create computer objects in Active Directory. Formato obligatorio: admin@contoso.com.Required format: admin@contoso.com.
adDomainPasswordadDomainPassword StringString La contraseña asociada a adDomainUsername.The password associated with adDomainUsername.
resourceGroupIdresourceGroupId StringString Identificador del grupo de recursos de destino.The ID of the target resource group. Formato obligatorio: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}".Required format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}".
virtualNetworkIdvirtualNetworkId StringString El identificador de la red virtual de destino.The ID of the target virtual network. Formato obligatorio: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}".Required format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}".
subnetIdsubnetId StringString Identificador de la subred de destino.The ID of the target subnet. Formato obligatorio: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}".Required format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}".

RespuestaResponse

Si se realiza correctamente, este método devuelve un código de respuesta y un objeto 201 Created cloudPcOnPremisesConnection en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a cloudPcOnPremisesConnection object in the response body.

EjemplosExamples

SolicitudRequest

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremisesConnections
Content-Type: application/json
Content-length: 800

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "displayName": "Display Name value",
  "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
  "subscriptionName": "Subscription Name value",
  "adDomainName": "Active Directory Domain Name value",
  "adDomainUsername": "Active Directory Domain User Name value",
  "organizationalUnit": "Organization Unit value",
  "resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG",
  "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet",
  "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default"
}

RespuestaResponse

Nota: Este es un ejemplo de la respuesta.Note: Here is an example of the response. El objeto de respuesta que se muestra aquí puede truncarse para abrevidad.The response object shown here may be truncated for brevity. Todas las propiedades se devolverán desde una llamada real.All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-length: 897

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "id": "ac2ad805-167e-49ee-9bef-196c4ce7ffff",
  "displayName": "Display Name value",
  "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
  "subscriptionName": "Subscription Name value",
  "adDomainName": "Active Directory Domain Name value",
  "adDomainUsername": "Active Directory Domain User Name value",
  "organizationalUnit": "Organization Unit value",
  "resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG",
  "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet",
  "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
  "healthCheckStatus": "pending"
}