github.com/twilio/twilio-go@v1.20.1/rest/microvisor/v1/docs/DevicesSecretsApi.md (about)

     1  # DevicesSecretsApi
     2  
     3  All URIs are relative to *https://microvisor.twilio.com*
     4  
     5  Method | HTTP request | Description
     6  ------------- | ------------- | -------------
     7  [**CreateDeviceSecret**](DevicesSecretsApi.md#CreateDeviceSecret) | **Post** /v1/Devices/{DeviceSid}/Secrets | 
     8  [**DeleteDeviceSecret**](DevicesSecretsApi.md#DeleteDeviceSecret) | **Delete** /v1/Devices/{DeviceSid}/Secrets/{Key} | 
     9  [**FetchDeviceSecret**](DevicesSecretsApi.md#FetchDeviceSecret) | **Get** /v1/Devices/{DeviceSid}/Secrets/{Key} | 
    10  [**ListDeviceSecret**](DevicesSecretsApi.md#ListDeviceSecret) | **Get** /v1/Devices/{DeviceSid}/Secrets | 
    11  [**UpdateDeviceSecret**](DevicesSecretsApi.md#UpdateDeviceSecret) | **Post** /v1/Devices/{DeviceSid}/Secrets/{Key} | 
    12  
    13  
    14  
    15  ## CreateDeviceSecret
    16  
    17  > MicrovisorV1DeviceSecret CreateDeviceSecret(ctx, DeviceSidoptional)
    18  
    19  
    20  
    21  Create a secret for a Microvisor Device.
    22  
    23  ### Path Parameters
    24  
    25  
    26  Name | Type | Description
    27  ------------- | ------------- | -------------
    28  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    29  **DeviceSid** | **string** | A 34-character string that uniquely identifies the Device.
    30  
    31  ### Other Parameters
    32  
    33  Other parameters are passed through a pointer to a CreateDeviceSecretParams struct
    34  
    35  
    36  Name | Type | Description
    37  ------------- | ------------- | -------------
    38  **Key** | **string** | The secret key; up to 100 characters.
    39  **Value** | **string** | The secret value; up to 4096 characters.
    40  
    41  ### Return type
    42  
    43  [**MicrovisorV1DeviceSecret**](MicrovisorV1DeviceSecret.md)
    44  
    45  ### Authorization
    46  
    47  [accountSid_authToken](../README.md#accountSid_authToken)
    48  
    49  ### HTTP request headers
    50  
    51  - **Content-Type**: application/x-www-form-urlencoded
    52  - **Accept**: application/json
    53  
    54  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    55  [[Back to Model list]](../README.md#documentation-for-models)
    56  [[Back to README]](../README.md)
    57  
    58  
    59  ## DeleteDeviceSecret
    60  
    61  > DeleteDeviceSecret(ctx, DeviceSidKey)
    62  
    63  
    64  
    65  Delete a secret for a Microvisor Device.
    66  
    67  ### Path Parameters
    68  
    69  
    70  Name | Type | Description
    71  ------------- | ------------- | -------------
    72  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    73  **DeviceSid** | **string** | A 34-character string that uniquely identifies the Device.
    74  **Key** | **string** | The secret key; up to 100 characters.
    75  
    76  ### Other Parameters
    77  
    78  Other parameters are passed through a pointer to a DeleteDeviceSecretParams struct
    79  
    80  
    81  Name | Type | Description
    82  ------------- | ------------- | -------------
    83  
    84  ### Return type
    85  
    86   (empty response body)
    87  
    88  ### Authorization
    89  
    90  [accountSid_authToken](../README.md#accountSid_authToken)
    91  
    92  ### HTTP request headers
    93  
    94  - **Content-Type**: Not defined
    95  - **Accept**: Not defined
    96  
    97  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    98  [[Back to Model list]](../README.md#documentation-for-models)
    99  [[Back to README]](../README.md)
   100  
   101  
   102  ## FetchDeviceSecret
   103  
   104  > MicrovisorV1DeviceSecret FetchDeviceSecret(ctx, DeviceSidKey)
   105  
   106  
   107  
   108  Retrieve a Secret for a Device.
   109  
   110  ### Path Parameters
   111  
   112  
   113  Name | Type | Description
   114  ------------- | ------------- | -------------
   115  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   116  **DeviceSid** | **string** | A 34-character string that uniquely identifies the Device.
   117  **Key** | **string** | The secret key; up to 100 characters.
   118  
   119  ### Other Parameters
   120  
   121  Other parameters are passed through a pointer to a FetchDeviceSecretParams struct
   122  
   123  
   124  Name | Type | Description
   125  ------------- | ------------- | -------------
   126  
   127  ### Return type
   128  
   129  [**MicrovisorV1DeviceSecret**](MicrovisorV1DeviceSecret.md)
   130  
   131  ### Authorization
   132  
   133  [accountSid_authToken](../README.md#accountSid_authToken)
   134  
   135  ### HTTP request headers
   136  
   137  - **Content-Type**: Not defined
   138  - **Accept**: application/json
   139  
   140  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   141  [[Back to Model list]](../README.md#documentation-for-models)
   142  [[Back to README]](../README.md)
   143  
   144  
   145  ## ListDeviceSecret
   146  
   147  > []MicrovisorV1DeviceSecret ListDeviceSecret(ctx, DeviceSidoptional)
   148  
   149  
   150  
   151  Retrieve a list of all Secrets for a Device.
   152  
   153  ### Path Parameters
   154  
   155  
   156  Name | Type | Description
   157  ------------- | ------------- | -------------
   158  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   159  **DeviceSid** | **string** | A 34-character string that uniquely identifies the Device.
   160  
   161  ### Other Parameters
   162  
   163  Other parameters are passed through a pointer to a ListDeviceSecretParams struct
   164  
   165  
   166  Name | Type | Description
   167  ------------- | ------------- | -------------
   168  **PageSize** | **int** | How many resources to return in each list page. The default is 50, and the maximum is 1000.
   169  **Limit** | **int** | Max number of records to return.
   170  
   171  ### Return type
   172  
   173  [**[]MicrovisorV1DeviceSecret**](MicrovisorV1DeviceSecret.md)
   174  
   175  ### Authorization
   176  
   177  [accountSid_authToken](../README.md#accountSid_authToken)
   178  
   179  ### HTTP request headers
   180  
   181  - **Content-Type**: Not defined
   182  - **Accept**: application/json
   183  
   184  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   185  [[Back to Model list]](../README.md#documentation-for-models)
   186  [[Back to README]](../README.md)
   187  
   188  
   189  ## UpdateDeviceSecret
   190  
   191  > MicrovisorV1DeviceSecret UpdateDeviceSecret(ctx, DeviceSidKeyoptional)
   192  
   193  
   194  
   195  Update a secret for a Microvisor Device.
   196  
   197  ### Path Parameters
   198  
   199  
   200  Name | Type | Description
   201  ------------- | ------------- | -------------
   202  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   203  **DeviceSid** | **string** | A 34-character string that uniquely identifies the Device.
   204  **Key** | **string** | The secret key; up to 100 characters.
   205  
   206  ### Other Parameters
   207  
   208  Other parameters are passed through a pointer to a UpdateDeviceSecretParams struct
   209  
   210  
   211  Name | Type | Description
   212  ------------- | ------------- | -------------
   213  **Value** | **string** | The secret value; up to 4096 characters.
   214  
   215  ### Return type
   216  
   217  [**MicrovisorV1DeviceSecret**](MicrovisorV1DeviceSecret.md)
   218  
   219  ### Authorization
   220  
   221  [accountSid_authToken](../README.md#accountSid_authToken)
   222  
   223  ### HTTP request headers
   224  
   225  - **Content-Type**: application/x-www-form-urlencoded
   226  - **Accept**: application/json
   227  
   228  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   229  [[Back to Model list]](../README.md#documentation-for-models)
   230  [[Back to README]](../README.md)
   231