Namespaces - Create Or Update
サービス名前空間を作成または更新します。 作成されると、この名前空間のリソース マニフェストは変更できません。 この操作はべき等です。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}?api-version=2021-11-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
namespace
|
path | True |
string |
名前空間の名前。 |
resource
|
path | True |
string |
Azure サブスクリプション内のリソース グループの名前。 |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。 |
api-version
|
query | True |
string |
クライアント API バージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
location | True |
string |
リソースが保存されている地理的な場所 |
identity.type |
マネージド サービス ID の種類。 |
||
identity.userAssignedIdentities |
<string,
User |
ユーザー割り当て ID のプロパティ |
|
properties.alternateName |
string |
名前空間の代替名 |
|
properties.disableLocalAuth |
boolean |
このプロパティは、Service Bus 名前空間の SAS 認証を無効にします。 |
|
properties.encryption.keySource |
暗号化の keySource の使用可能な値を列挙します |
||
properties.encryption.keyVaultProperties |
KeyVault のプロパティ |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
インフラストラクチャ暗号化を有効にする (二重暗号化) |
|
properties.privateEndpointConnections |
プライベート エンドポイント接続の一覧。 |
||
properties.zoneRedundant |
boolean |
このプロパティを有効にすると、サポートされている可用性ゾーンのリージョンに Premium Service Bus 名前空間が作成されます。 |
|
sku |
SKU のプロパティ |
||
tags |
object |
リソース タグ |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
名前空間が正常に作成されました。 |
|
201 Created |
名前空間の作成要求が受け入れられます。 |
|
202 Accepted |
名前空間の作成または更新要求が受け入れられます。 |
|
Other Status Codes |
操作が失敗した理由を説明する ServiceBus エラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
NameSpaceCreate
Sample Request
PUT https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace2924?api-version=2021-11-01
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
}
}
Sample Response
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-2924",
"name": "sdk-Namespace-2924",
"type": "Microsoft.ServiceBus/Namespaces",
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"provisioningState": "Created",
"metricId": "5f750a97-50d9-4e36-8081-c9ee4c0210d4:sdk-namespace-2924",
"createdAt": "2017-05-25T22:26:36.76Z",
"updatedAt": "2017-05-25T22:26:36.76Z",
"serviceBusEndpoint": "https://sdk-Namespace-2924.servicebus.windows-int.net:443/"
}
}
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-2924",
"name": "sdk-Namespace-2924",
"type": "Microsoft.ServiceBus/Namespaces",
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"provisioningState": "Created",
"metricId": "5f750a97-50d9-4e36-8081-c9ee4c0210d4:sdk-namespace-2924",
"createdAt": "2017-05-25T22:26:36.76Z",
"updatedAt": "2017-05-25T22:26:36.76Z",
"serviceBusEndpoint": "https://sdk-Namespace-2924.servicebus.windows-int.net:443/",
"disableLocalAuth": false
}
}
定義
名前 | 説明 |
---|---|
Connection |
ConnectionState 情報。 |
created |
リソースを作成した ID の種類。 |
End |
プライベート エンドポイント接続のプロビジョニング状態。 |
Error |
error オブジェクト。 |
Error |
リソース管理エラーの追加情報。 |
Error |
リソース管理エラー応答。 |
key |
暗号化の keySource の使用可能な値を列挙します |
Key |
keyVault プロパティを構成するプロパティ |
Managed |
マネージド サービス ID の種類。 |
Private |
PrivateEndpoint 情報。 |
Private |
PrivateEndpointConnection のプロパティ。 |
Private |
接続の状態。 |
SBNamespace |
名前空間リソースの説明。 |
SBSku |
名前空間の SKU。 |
Sku |
この SKU の名前。 |
Sku |
この特定の SKU の課金レベル。 |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
User |
認識されたディクショナリ値。 |
ConnectionState
ConnectionState 情報。
名前 | 型 | 説明 |
---|---|---|
description |
string |
接続状態の説明。 |
status |
接続の状態。 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EndPointProvisioningState
プライベート エンドポイント接続のプロビジョニング状態。
名前 | 型 | 説明 |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Error
error オブジェクト。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorResponse
リソース管理エラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
keySource
暗号化の keySource の使用可能な値を列挙します
名前 | 型 | 説明 |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
keyVault プロパティを構成するプロパティ
名前 | 型 | 説明 |
---|---|---|
identity.userAssignedIdentity |
string |
暗号化用に選択されたユーザー ID の ARM ID |
keyName |
string |
KeyVault からのキーの名前 |
keyVaultUri |
string |
KeyVault の URI |
keyVersion |
string |
KeyVault のバージョン |
ManagedServiceIdentityType
マネージド サービス ID の種類。
名前 | 型 | 説明 |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
PrivateEndpoint 情報。
名前 | 型 | 説明 |
---|---|---|
id |
string |
プライベート エンドポイントの ARM 識別子。 |
PrivateEndpointConnection
PrivateEndpointConnection のプロパティ。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
リソースが保存されている地理的な場所 |
name |
string |
リソースの名前 |
properties.privateEndpoint |
この接続のプライベート エンドポイント リソース。 |
|
properties.privateLinkServiceConnectionState |
接続の状態の詳細。 |
|
properties.provisioningState |
プライベート エンドポイント接続のプロビジョニング状態。 |
|
systemData |
このリソースに関連するシステム メタデータ。 |
|
type |
string |
リソースの型。 例: "Microsoft.EventHub/Namespaces" または "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
接続の状態。
名前 | 型 | 説明 |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
SBNamespace
名前空間リソースの説明。
名前 | 型 | 既定値 | 説明 |
---|---|---|---|
id |
string |
リソース ID |
|
identity.principalId |
string |
KeyVault からの ObjectId |
|
identity.tenantId |
string |
KeyVault からの TenantId |
|
identity.type |
マネージド サービス ID の種類。 |
||
identity.userAssignedIdentities |
<string,
User |
ユーザー割り当て ID のプロパティ |
|
location |
string |
リソースが保存されている地理的な場所 |
|
name |
string |
リソース名 |
|
properties.alternateName |
string |
名前空間の代替名 |
|
properties.createdAt |
string |
名前空間が作成された時刻 |
|
properties.disableLocalAuth |
boolean |
このプロパティは、Service Bus 名前空間の SAS 認証を無効にします。 |
|
properties.encryption.keySource | Microsoft.KeyVault |
暗号化の keySource の使用可能な値を列挙します |
|
properties.encryption.keyVaultProperties |
KeyVault のプロパティ |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
インフラストラクチャ暗号化を有効にする (二重暗号化) |
|
properties.metricId |
string |
Azure Insights メトリックの識別子 |
|
properties.privateEndpointConnections |
プライベート エンドポイント接続の一覧。 |
||
properties.provisioningState |
string |
名前空間のプロビジョニング状態。 |
|
properties.serviceBusEndpoint |
string |
Service Bus 操作の実行に使用できるエンドポイント。 |
|
properties.status |
string |
名前空間の状態。 |
|
properties.updatedAt |
string |
名前空間が更新された時刻。 |
|
properties.zoneRedundant |
boolean |
このプロパティを有効にすると、サポートされている可用性ゾーンのリージョンに Premium Service Bus 名前空間が作成されます。 |
|
sku |
SKU のプロパティ |
||
systemData |
このリソースに関連するシステム メタデータ。 |
||
tags |
object |
リソース タグ |
|
type |
string |
リソースの種類 |
SBSku
名前空間の SKU。
名前 | 型 | 説明 |
---|---|---|
capacity |
integer |
レベルに指定されたメッセージング ユニット。 Premium レベルの場合、容量は 1、2、4 です。 |
name |
この SKU の名前。 |
|
tier |
この特定の SKU の課金レベル。 |
SkuName
この SKU の名前。
名前 | 型 | 説明 |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
この特定の SKU の課金レベル。
名前 | 型 | 説明 |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースを最後に変更した ID の種類。 |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |
UserAssignedIdentity
認識されたディクショナリ値。
名前 | 型 | 説明 |
---|---|---|
clientId |
string |
ユーザー割り当て ID のクライアント ID |
principalId |
string |
ユーザー割り当て ID のプリンシパル ID |