Create Deployment 非同期操作は、新しいサービス パッケージをアップロードし、ステージング環境または運用環境に新しいデプロイを作成します。
この操作を実行する前に、次の作業を完了する必要があります。
サブスクリプションを作成して、サブスクリプション識別子を取得します。 サブスクリプション識別子は、管理ポータルの [設定] ページで取得できます。
操作を承認するための管理証明書を作成しアップロードします。
クラウド サービスを作成します。
ステージング環境または運用環境にアプリケーションをデプロイするかどうかを決定します。
要求
要求は Create Deployment 次のように指定されます。
<subscription-id> をサブスクリプション ID で、<cloudservice-name> をクラウド サービスの名前で、<deployment-slot> を staging または production でそれぞれ置き換えます。
| Method | 要求 URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot> |
URI パラメーター
なし。
要求ヘッダー
要求ヘッダーの説明を次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Content-Type |
必須。 このヘッダーには、application/xml を設定します。 |
x-ms-version |
必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーは 以上に設定する 2009-10-01 必要があります。 |
要求本文
要求本文の形式は次のとおりです。
<?xml version="1.0" encoding="utf-8"?>
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">
<Name>deployment-name</Name>
<PackageUrl>package-url-in-blob-storage</PackageUrl>
<Label>base64-encoded-deployment-label</Label>
<Configuration>base64-encoded-configuration-file</Configuration>
<StartDeployment>start-deployment</StartDeployment>
<TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>
<ExtendedProperties>
<ExtendedProperty>
<Name>property-name</Name>
<Value>property-value</Value>
</ExtendedProperty>
</ExtendedProperties>
<ExtensionConfiguration>
<AllRoles>
<Extension>
<Id>identifier-of-extension</Id>
<State>state-of-extension</State>
</Extension>
</AllRoles>
<NamedRoles>
<Role>
<RoleName>role_name1</RoleName>
<Extensions>
<Extension>
<Id>identifier-of-extension</Id>
<State>state-of-extension</State>
</Extension>
</Extensions>
</Role>
</NamedRoles>
</ExtensionConfiguration>
</CreateDeployment>
要求本文の要素を次の表に示します。
| 要素名 | 説明 |
|---|---|
| 名前 | 必須。 展開の名前を指定します。 |
| PackageUrl | 必須。 BLOB Service 内のサービス パッケージの場所を表す URL を指定します。 サービス パッケージは、同じサブスクリプションのストレージ アカウント、または任意のストレージ アカウントの共有アクセス署名 (SAS) URI にあります。 |
| 構成 | 必須。 デプロイの Base 64 エンコード サービス構成ファイルを指定します。 |
| Label | 必須。 Base 64 でエンコードされたデプロイの識別子を指定します。 識別子の最大長は 100 文字です。 サブスクリプション内で一意のラベルを使用することをお勧めします。 ラベルは追跡の目的で使用できます。 |
| StartDeployment | 省略可能。 作成後すぐにデプロイを開始するかどうかを指定します。 既定値は false です。false の場合、サービス モデルは引き続きデプロイされますが、コードはすぐには実行されません。 代わりに、サービスは Suspended Update Deployment Status を呼び出し、状態を に Running設定するまでです。この時点でサービスが開始されます。 デプロイされたサービスについては、中断されていても料金がかかります。要素は StartDeployment 、バージョン 2010-04-01 以降のみを使用して使用できます。 |
| TreatWarningsAsError | 省略可能。 パッケージの検証警告をエラーとして処理するかどうかを示します。 既定値は false です。
true に設定した場合、サービス パッケージの検証警告があると、Created Deployment 操作は失敗します。TreatWarningsAsError 要素は、バージョン 01.04.11 以上を使用している場合のみ使用できます。 |
| 名前 | 省略可能。 デプロイの拡張プロパティの名前を指定します。 各拡張プロパティには、定義済みの名前と値の両方が必要です。 最大 25 個の拡張プロパティ名と値のペアを使用できます。 Name 要素の最大長は 64 文字です。Name では英数字とアンダースコアのみが有効であり、名前の先頭にはアルファベットを使用する必要があります。 Name 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。 |
| 値 | 省略可能。 クラウド サービスの拡張プロパティの値を指定します。 各拡張プロパティには、定義済みの名前と値の両方が必要です。 最大 25 個の拡張プロパティ名と値のペアを指定でき、各拡張プロパティ値の最大長は 255 文字です。Value 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。 |
| ExtensionConfiguration | 省略可能。 クラウド サービスに追加される拡張機能を指定します。 Azure では、プロセスはクラウド サービスの拡張機能として実行できます。 デプロイに追加する前に、 拡張機能の追加 を使用してクラウド サービスに拡張機能を追加する必要があります。ExtensionConfiguration 要素は、バージョン 01.03.13 以上を使用している場合のみ使用できます。 |
ExtensionConfiguration
クラウド サービスに追加される拡張機能を指定します。
| 要素名 | 説明 |
|---|---|
| AllRoles | 省略可能。 デプロイ内のすべてのロールに適用される拡張機能のリストを指定します。 |
| 拡張子 | 必須。 クラウド サービスのロールにデプロイされる拡張機能を指定します。 |
| NamedRoles | 省略可能。 デプロイの特定のロールに適用される拡張機能のリストを指定します。 |
拡張機能
クラウド サービスのロールにデプロイされる拡張機能を指定します。
| 要素名 | 説明 |
|---|---|
| Id | 必須。 拡張機能の識別子を指定します。 識別子は、クラウド サービスに拡張機能が追加されると作成されます。 List Extensions を使用すると、クラウド サービスに追加された拡張機能の識別子を確認できます。 |
| State | 省略可能。 拡張機能の状態を指定します。 この要素は JSON で構成された拡張機能にのみ適用されます。 次のいずれかの値になります。 - Enable- Disable- Uninstall既定値は Enable です。State 要素は、バージョン 01.06.14 以上を使用している場合のみ使用できます。 |
NamedRoles
デプロイの特定のロールに適用される拡張機能のリストを指定します。
| 要素名 | 説明 |
|---|---|
| Role | 必須。 拡張機能が追加される特定のロールを指定します。 |
| RoleName | 必須。 ロール名を指定します。 |
| 拡張子 | 必須。 クラウド サービスのロールにデプロイされる拡張機能を指定します。 |
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作に成功すると、状態コード 200 (OK) が返されます。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。
| 応答ヘッダー | Description |
|---|---|
x-ms-request-id |
管理サービスに対して行われた要求を一意に識別する値。 非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を 呼び出して、操作が完了したか、失敗したか、またはまだ進行中であるかを判断できます。 |
応答本文
なし。