Sims - Create Or Update
建立或更新 SIM 卡。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
資源群組的名稱。 名稱不區分大小寫。 |
sim
|
path | True |
string |
SIM 群組的名稱。 Regex 模式: |
sim
|
path | True |
string |
SIM 的名稱。 Regex 模式: |
subscription
|
path | True |
string uuid |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
properties.internationalMobileSubscriberIdentity | True |
string |
SIM 卡的國際行動裝置訂閱者身分識別 (IMSI) 。 |
properties.authenticationKey |
string |
SIM 卡的 Ki 值。 |
|
properties.deviceType |
string |
選擇性自由格式文字欄位,可用來錄製與此 SIM 卡相關聯的裝置類型,例如「視訊相機」。 Azure 入口網站 允許根據此值來分組和篩選 SIM。 |
|
properties.integratedCircuitCardIdentifier |
string |
SIM 卡的整合卡標識碼 () 。 |
|
properties.operatorKeyCode |
string |
SIM 卡的 Opc 值。 |
|
properties.simPolicy |
此 SIM 卡所使用的 SIM 原則。 SIM 原則必須位於與 SIM 卡相同的位置。 |
||
properties.staticIpConfiguration |
指派給此 SIM 卡的靜態 IP 位址清單。 每個地址都會在定義的網路範圍指派,由 {附加的數據網路、配量}組成。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
更新成功。 作業會傳回產生的 SIM 資源。 |
|
201 Created |
Create 成功。 作業會傳回產生的 SIM 資源。 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
Create SIM
範例要求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01
{
"properties": {
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"authenticationKey": "00000000000000000000000000000000",
"operatorKeyCode": "00000000000000000000000000000000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
範例回覆
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Succeeded",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Created",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
定義
名稱 | Description |
---|---|
Attached |
附加數據網路資源的參考。 |
created |
建立資源的身分識別類型。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Provisioning |
目前的布建狀態。 |
Sim |
SIM 資源。 |
Sim |
SIM 卡原則資源的參考。 |
Sim |
SIM 資源的狀態。 |
Sim |
SIM 卡的靜態 IP 組態,範圍限定於特定的鏈接數據網路和配量。 |
Slice |
配量資源的參考。 |
Static |
SIM 卡在定義的網路範圍中使用的靜態 IP 組態。 |
system |
與建立和上次修改資源相關的元數據。 |
AttachedDataNetworkResourceId
附加數據網路資源的參考。
名稱 | 類型 | Description |
---|---|---|
id |
string |
鏈接的數據網路資源標識碼。 |
createdByType
建立資源的身分識別類型。
名稱 | 類型 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
ProvisioningState
目前的布建狀態。
名稱 | 類型 | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Unknown |
string |
Sim
SIM 資源。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源識別碼。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
name |
string |
資源的名稱 |
properties.authenticationKey |
string |
SIM 卡的 Ki 值。 |
properties.deviceType |
string |
選擇性自由格式文字欄位,可用來錄製與此 SIM 卡相關聯的裝置類型,例如「視訊相機」。 Azure 入口網站 允許根據此值來分組和篩選 SIM。 |
properties.integratedCircuitCardIdentifier |
string |
SIM 卡的整合卡標識碼 () 。 |
properties.internationalMobileSubscriberIdentity |
string |
SIM 卡的國際行動裝置訂閱者身分識別 (IMSI) 。 |
properties.operatorKeyCode |
string |
SIM 卡的 Opc 值。 |
properties.provisioningState |
SIM 資源的布建狀態。 |
|
properties.simPolicy |
此 SIM 卡所使用的 SIM 原則。 SIM 原則必須位於與 SIM 卡相同的位置。 |
|
properties.simState |
SIM 資源的狀態。 |
|
properties.siteProvisioningState |
object |
月臺字典,指向該站臺上此 SIM 卡的布建狀態。 |
properties.staticIpConfiguration |
指派給此 SIM 卡的靜態 IP 位址清單。 每個地址都會在定義的網路範圍指派,由 {附加的數據網路、配量}組成。 |
|
properties.vendorKeyFingerprint |
string |
如果有的話,提供此 SIM 卡之 SIM 廠商的公鑰指紋。 |
properties.vendorName |
string |
如果有的話,提供此 SIM 卡的 SIM 廠商名稱。 |
systemData |
Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。 |
|
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
SimPolicyResourceId
SIM 卡原則資源的參考。
名稱 | 類型 | Description |
---|---|---|
id |
string |
SIM 原則資源識別碼。 |
SimState
SIM 資源的狀態。
名稱 | 類型 | Description |
---|---|---|
Disabled |
string |
SIM 卡已停用,因為並非所有啟用所需的設定都存在。 |
Enabled |
string |
已啟用 SIM 卡。 |
Invalid |
string |
無法啟用 SIM 卡,因為某些相關聯的組態無效。 |
SimStaticIpProperties
SIM 卡的靜態 IP 組態,範圍限定於特定的鏈接數據網路和配量。
名稱 | 類型 | Description |
---|---|---|
attachedDataNetwork |
將使用靜態IP位址的附加資料網路。 鏈接數據網路和配量的組合會定義IP位址的網路範圍。 連接的數據網路必須位於與 SIM 卡相同的位置。 |
|
slice |
將使用靜態IP位址的網路配量。 鏈接數據網路和配量的組合會定義IP位址的網路範圍。 配量必須位於與 SIM 卡相同的位置。 |
|
staticIp |
SIM 卡在定義的網路範圍中使用的靜態 IP 組態。 |
SliceResourceId
配量資源的參考。
名稱 | 類型 | Description |
---|---|---|
id |
string |
配量資源標識碼。 |
StaticIp
SIM 卡在定義的網路範圍中使用的靜態 IP 組態。
名稱 | 類型 | Description |
---|---|---|
ipv4Address |
string |
在此網路範圍指派給 SIM 卡的 IPv4 位址。 此位址必須位於鏈接數據網路中定義的userEquipmentStaticAddressPoolPrefix 中。 |
systemData
與建立和上次修改資源相關的元數據。
名稱 | 類型 | Description |
---|---|---|
createdAt |
string |
資源建立的時間戳 (UTC) 。 |
createdBy |
string |
建立資源的身分識別。 |
createdByType |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |