|
| 1 | +# Azure CLI storagecache Extension # |
| 2 | +This is the extension for storagecache |
| 3 | + |
| 4 | +### How to use ### |
| 5 | +Install this extension using the below CLI command |
| 6 | +``` |
| 7 | +az extension add --name storagecache |
| 8 | +``` |
| 9 | + |
| 10 | +### Included Features ### |
| 11 | +#### storagecache sku #### |
| 12 | +##### List ##### |
| 13 | +``` |
| 14 | +az storagecache sku list |
| 15 | +``` |
| 16 | +#### storagecache usage-model #### |
| 17 | +##### List ##### |
| 18 | +``` |
| 19 | +az storagecache usage-model list |
| 20 | +``` |
| 21 | +#### storagecache asc-operation #### |
| 22 | +##### Show ##### |
| 23 | +``` |
| 24 | +az storagecache asc-operation show --operation-id "testoperationid" --location "westus" |
| 25 | +``` |
| 26 | +#### storagecache #### |
| 27 | +##### Create ##### |
| 28 | +``` |
| 29 | +az storagecache create --type "UserAssigned" \ |
| 30 | + --user-assigned-identities "{\\"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1\\":{}}" \ |
| 31 | + --location "westus" --cache-size-gb 3072 --cache-net-bios-name "contosoSmb" \ |
| 32 | + --cache-active-directory-settings-credentials password="<password>" username="consotoAdmin" \ |
| 33 | + --domain-name "contosoAd.contoso.local" --domain-net-bios-name "contosoAd" --primary-dns-ip-address "192.0.2.10" \ |
| 34 | + --secondary-dns-ip-address "192.0.2.11" \ |
| 35 | + --credentials bind-dn="cn=ldapadmin,dc=contosoad,dc=contoso,dc=local" bind-password="<bindPassword>" \ |
| 36 | + --extended-groups true --ldap-base-dn "dc=contosoad,dc=contoso,dc=local" --ldap-server "192.0.2.12" \ |
| 37 | + --username-source "LDAP" --key-url "https://keyvault-cmk.vault.azure.net/keys/key2047/test" \ |
| 38 | + --id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.KeyVault/vaults/keyvault-cmk" \ |
| 39 | + --access-policies name="default" access-rules={"access":"rw","rootSquash":false,"scope":"default","submountAccess":true,"suid":false} \ |
| 40 | + --subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub1" \ |
| 41 | + --name "Standard_2G" --tags Dept="Contoso" --cache-name "sc1" --resource-group "scgroup" |
| 42 | +``` |
| 43 | +##### Create ##### |
| 44 | +``` |
| 45 | +az storagecache create --location "westus" --cache-size-gb 3072 \ |
| 46 | + --credentials bind-dn="cn=ldapadmin,dc=contosoad,dc=contoso,dc=local" bind-password="<bindPassword>" \ |
| 47 | + --extended-groups true --ldap-base-dn "dc=contosoad,dc=contoso,dc=local" --ldap-server "192.0.2.12" \ |
| 48 | + --username-source "LDAP" --key-url "https://keyvault-cmk.vault.azure.net/keys/key2048/test" \ |
| 49 | + --id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.KeyVault/vaults/keyvault-cmk" \ |
| 50 | + --access-policies name="default" access-rules={"access":"rw","rootSquash":false,"scope":"default","submountAccess":true,"suid":false} \ |
| 51 | + --subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub1" \ |
| 52 | + --name "Standard_2G" --tags Dept="Contoso" --cache-name "sc1" --resource-group "scgroup" |
| 53 | +``` |
| 54 | +##### List ##### |
| 55 | +``` |
| 56 | +az storagecache list --resource-group "scgroup" |
| 57 | +``` |
| 58 | +##### Show ##### |
| 59 | +``` |
| 60 | +az storagecache show --cache-name "sc1" --resource-group "scgroup" |
| 61 | +``` |
| 62 | +##### Update ##### |
| 63 | +``` |
| 64 | +az storagecache update --location "westus" --cache-size-gb 3072 --cache-net-bios-name "contosoSmb" \ |
| 65 | + --domain-name "contosoAd.contoso.local" --domain-net-bios-name "contosoAd" --primary-dns-ip-address "192.0.2.10" \ |
| 66 | + --secondary-dns-ip-address "192.0.2.11" --extended-groups true --username-source "AD" \ |
| 67 | + --network-settings dns-search-domain="contoso.com" dns-servers="10.1.22.33" dns-servers="10.1.12.33" mtu=1500 ntp-server="time.contoso.com" \ |
| 68 | + --access-policies name="default" access-rules={"access":"rw","rootSquash":false,"scope":"default","submountAccess":true,"suid":false} \ |
| 69 | + --access-policies name="restrictive" access-rules={"access":"rw","filter":"10.99.3.145","rootSquash":false,"scope":"host","submountAccess":true,"suid":true} access-rules={"access":"rw","filter":"10.99.1.0/24","rootSquash":false,"scope":"network","submountAccess":true,"suid":true} access-rules={"access":"no","anonymousGID":"65534","anonymousUID":"65534","rootSquash":true,"scope":"default","submountAccess":true,"suid":false} \ |
| 70 | + --subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub1" \ |
| 71 | + --name "Standard_2G" --tags Dept="Contoso" --cache-name "sc1" --resource-group "scgroup" |
| 72 | +``` |
| 73 | +##### Update ##### |
| 74 | +``` |
| 75 | +az storagecache update --location "westus" --cache-size-gb 3072 \ |
| 76 | + --credentials bind-dn="cn=ldapadmin,dc=contosoad,dc=contoso,dc=local" bind-password="<bindPassword>" \ |
| 77 | + --extended-groups true --ldap-base-dn "dc=contosoad,dc=contoso,dc=local" --ldap-server "192.0.2.12" \ |
| 78 | + --username-source "LDAP" \ |
| 79 | + --network-settings dns-search-domain="contoso.com" dns-servers="10.1.22.33" dns-servers="10.1.12.33" mtu=1500 ntp-server="time.contoso.com" \ |
| 80 | + --access-policies name="default" access-rules={"access":"rw","rootSquash":false,"scope":"default","submountAccess":true,"suid":false} \ |
| 81 | + --access-policies name="restrictive" access-rules={"access":"rw","filter":"10.99.3.145","rootSquash":false,"scope":"host","submountAccess":true,"suid":true} access-rules={"access":"rw","filter":"10.99.1.0/24","rootSquash":false,"scope":"network","submountAccess":true,"suid":true} access-rules={"access":"no","anonymousGID":"65534","anonymousUID":"65534","rootSquash":true,"scope":"default","submountAccess":true,"suid":false} \ |
| 82 | + --subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub1" \ |
| 83 | + --name "Standard_2G" --tags Dept="Contoso" --cache-name "sc1" --resource-group "scgroup" |
| 84 | +``` |
| 85 | +##### Debug-info ##### |
| 86 | +``` |
| 87 | +az storagecache debug-info --cache-name "sc" --resource-group "scgroup" |
| 88 | +``` |
| 89 | +##### Flush ##### |
| 90 | +``` |
| 91 | +az storagecache flush --cache-name "sc" --resource-group "scgroup" |
| 92 | +``` |
| 93 | +##### Start ##### |
| 94 | +``` |
| 95 | +az storagecache start --cache-name "sc" --resource-group "scgroup" |
| 96 | +``` |
| 97 | +##### Stop ##### |
| 98 | +``` |
| 99 | +az storagecache stop --cache-name "sc" --resource-group "scgroup" |
| 100 | +``` |
| 101 | +##### Upgrade-firmware ##### |
| 102 | +``` |
| 103 | +az storagecache upgrade-firmware --cache-name "sc1" --resource-group "scgroup" |
| 104 | +``` |
| 105 | +##### Delete ##### |
| 106 | +``` |
| 107 | +az storagecache delete --cache-name "sc" --resource-group "scgroup" |
| 108 | +``` |
| 109 | +#### storagecache storage-target #### |
| 110 | +##### Create ##### |
| 111 | +``` |
| 112 | +az storagecache storage-target create --cache-name "sc1" --resource-group "scgroup" --name "st1" \ |
| 113 | + --junctions namespace-path="/path/on/cache" nfs-access-policy="default" nfs-export="exp1" target-path="/path/on/exp1" \ |
| 114 | + --junctions namespace-path="/path2/on/cache" nfs-access-policy="rootSquash" nfs-export="exp2" target-path="/path2/on/exp2" \ |
| 115 | + --nfs3 target="10.0.44.44" usage-model="READ_HEAVY_INFREQ" --target-type "nfs3" |
| 116 | +
|
| 117 | +az storagecache storage-target wait --created --resource-group "{rg}" --name "{myStorageTarget}" |
| 118 | +``` |
| 119 | +##### Create ##### |
| 120 | +``` |
| 121 | +az storagecache storage-target create --cache-name "sc1" --resource-group "scgroup" --name "st1" \ |
| 122 | + --blob-nfs target="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Storage/storageAccounts/blofnfs/blobServices/default/containers/blobnfs" usage-model="WRITE_WORKLOAD_15" \ |
| 123 | + --junctions namespace-path="/blobnfs" --target-type "blobNfs" |
| 124 | +
|
| 125 | +az storagecache storage-target wait --created --resource-group "{rg}" --name "{myStorageTarget}" |
| 126 | +``` |
| 127 | +##### Create ##### |
| 128 | +``` |
| 129 | +az storagecache storage-target create --cache-name "sc1" --resource-group "scgroup" --name "st1" \ |
| 130 | + --nfs3 target="10.0.44.44" usage-model="READ_HEAVY_INFREQ" --target-type "nfs3" |
| 131 | +
|
| 132 | +az storagecache storage-target wait --created --resource-group "{rg}" --name "{myStorageTarget}" |
| 133 | +``` |
| 134 | +##### Show ##### |
| 135 | +``` |
| 136 | +az storagecache storage-target show --cache-name "sc1" --resource-group "scgroup" --name "st1" |
| 137 | +``` |
| 138 | +##### List ##### |
| 139 | +``` |
| 140 | +az storagecache storage-target list --cache-name "sc1" --resource-group "scgroup" |
| 141 | +``` |
| 142 | +##### Dns-refresh ##### |
| 143 | +``` |
| 144 | +az storagecache storage-target dns-refresh --cache-name "sc" --resource-group "scgroup" --name "st1" |
| 145 | +``` |
| 146 | +##### Delete ##### |
| 147 | +``` |
| 148 | +az storagecache storage-target delete --cache-name "sc1" --resource-group "scgroup" --name "st1" |
| 149 | +``` |
| 150 | +#### storagecache storage-target #### |
| 151 | +##### Flush ##### |
| 152 | +``` |
| 153 | +az storagecache storage-target flush --cache-name "sc" --resource-group "scgroup" --name "st1" |
| 154 | +``` |
| 155 | +##### Resume ##### |
| 156 | +``` |
| 157 | +az storagecache storage-target resume --cache-name "sc" --resource-group "scgroup" --name "st1" |
| 158 | +``` |
| 159 | +##### Suspend ##### |
| 160 | +``` |
| 161 | +az storagecache storage-target suspend --cache-name "sc" --resource-group "scgroup" --name "st1" |
| 162 | +``` |
0 commit comments