Partager via


Mettre à l’échelle un rôle de machine virtuelle [SPFSDK][VMROLE]

 

S’applique à : Windows Azure Pack

Les rôles de machine virtuelle (rôle de machine virtuelle) représentent une ou plusieurs machines virtuelles dédiées à une opération spécifique, comme un serveur web ou un worker web. Parfois, vous devrez peut-être ajuster le nombre de machines virtuelles d’un rôle de machine virtuelle particulière instanciée. Le rôle de machine virtuelle fournit une opération d’échelle qui vous permet d’ajuster les instances de machine virtuelle. La quantité d’instances de machine virtuelle ne peut jamais dépasser les instances minimales et supérieures aux instances de machine virtuelle maximale autorisées, comme configuré par le rôle de machine virtuelle.

Mettre à l’échelle un rôle de machine virtuelle

L’opération de mise à l’échelle est disponible dans l’URI de l’instance de rôle de machine virtuelle : http:// server-name:server-port/subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale?api-version=2013-03. Le corps HTTP de la requête doit être un objet JSON avec une propriété unique nommée InstanceCount. La valeur de cette propriété doit être le nombre absolu d’instances de machine virtuelle.

Envoyez une requête HTTP POST à l’URI du serveur référencé ci-dessus.

Conseil

Pour plus d’informations sur les espaces réservés utilisés dans l’URL, consultez La feuille de triche d’URL pour les rôles de machine virtuelle [SPFSDK][VMROLE].

Important

Chaque fois que vous accédez à une ressource dans les services cloud, vous devez ajouter la chaîne de requête API-version=2013-03 . La chaîne de requête commence toujours par le caractère ? après l’URL.

Une fois l’opération de mise à l’échelle lancée, la propriété ProvisioningState du rôle de machine virtuelle passe à Provisionnement. Actualisez l’instance de rôle de machine virtuelle à partir du serveur et attendez que la propriété ProvisioningState passe à Provisioned ou Failed. Si la valeur a échoué, consultez Inspecter un rôle de machine virtuelle pour les erreurs d’approvisionnement [SPFSDK][VMROLE] pour plus d’informations.

Mettre à l’échelle les instances de machines virtuelles d’une instance de rôle de machine virtuelle avec HTTP

  1. Utilisez une opération GET HTTP.

  2. Définissez l’URI de l’opération HTTP au format précédemment décrit.

  3. Définissez l’en-tête x-ms-principal-id sur l’e-mail du locataire associé à l’abonnement actuel.

  4. Si vous souhaitez utiliser json comme type de réponse, ajoutez l’en-tête Accept et définissez la valeur sur application/json

  5. Définissez tous les autres en-têtes HTTP standard, tels que ceux liés aux jetons d’authentification, et ajoutez tous les certificats d’authentification qui peuvent être requis.

  6. Créez le corps de la requête HTTP, qui doit être un objet JSON.

  7. Créez une propriété sur l’objet JSON nommé InstanceCount et définissez la valeur sur le nombre absolu d’instances de machine virtuelle.

  8. Envoyez la demande.

Requête HTTP GET

POST https://smapi-server:30005/f86b0bc2-6825-4e5b-961b-10d5901f7572/CloudServices/testquickvm/Resources/MicrosoftCompute/VMRoles/testquickvm/Scale?api-version=2013-03 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6InhUOE1XSFJ0aDVGVmNNSS1CTWlqWTc1Q1dhOCJ9.eyJpc3MiOiJodHRwOi8vYXp1cmVzZXJ2aWNlcy9BdXRoU2l0ZSIsImF1ZCI6Imh0dHA6Ly9henVyZXNlcnZpY2VzL1RlbmFudFNpdGUiLCJuYmYiOjEzODUwODA4MzksImV4cCI6MTM4NTEwOTYzOSwidXBuIjoiZnJlZEBmcmVkLmNvbSIsImF1dGhfdGltZSI6IjIwMTMtMTEtMjJUMDA6NDA6MzkuNjk2WiIsImF1dGhtZXRob2QiOiJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvYXV0aGVudGljYXRpb25tZXRob2QvcGFzc3dvcmQifQ.NlxoyYptJqoPRCQnprSvwdPTLbl3wgUjCKSKaMgbwIlKJ_8Gs2Z9Uf8Euj557hWPI5Gj7o5wjkfqXoun1RjUoyXd3DUyYSQ2WCbqBWEGNQt0dW9gz_v7TpzliqXqDkHKQJrOGkexSb0t0dg4ncmoD3by3ambirnYmfsPAwahiqVmIi5J3SyA8gpeMnwEmCJZVeta4NAqfWvJNaW7JEb2rZYyDsUdCVeQOzO0Dr57IdeyMecHKTeE53QkQG-g86bVx_OmXvNMR_reoraVGnfNz5LgH4tywkc70RtdW3zQDCA-aOLvt87Et35TvuDRiHg4qlDwcoQORQ0gtH0htIaF8w
x-ms-principal-id: user@contoso.com
Accept: application/json
Content-Type: application/json
Host: smapi-server:30005
Content-Length: 22
Expect: 100-continue

{ "InstanceCount": 2 }

Réponse HTTP GET

HTTP/1.1 204 No Content
Cache-Control: no-cache
Content-Length: 0
Server: Microsoft-IIS/8.5
x-ms-request-id: eaaf0fea-c921-488b-a61e-b6d91d2e99e2
X-Content-Type-Options: nosniff
request-id: 33c9dafc-df0d-0000-7df9-ca330ddfce01
DataServiceVersion: 1.0;
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ASP.NET
Date: Fri, 22 Nov 2013 00:40:45 GMT

Voir aussi

Instances de rôle de machine virtuelle [SPFSDK][VMROLE]
Obtenir une instance de rôle de machine virtuelle [SPFSDK][VMROLE]
Obtenez tous les Machines Virtuelles [SPFSDK][VMROLE]
Obtenir une machine virtuelle unique [SPFSDK][VMROLE]
Réparer un rôle de machine virtuelle [SPFSDK][VMROLE]