snippet_metadata.google.spanner.admin.instance.v1.json

{
  "clientLibrary": {
    "name": "cloud.google.com/go/spanner/admin/instance/apiv1",
    "version": "1.46.0",
    "language": "GO",
    "apis": [
      {
        "id": "google.spanner.admin.instance.v1",
        "version": "v1"
      }
    ]
  },
  "snippets": [
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_CreateInstance_sync",
      "title": "spanner CreateInstance Sample",
      "description": "CreateInstance creates an instance and begins preparing it to begin serving. The\nreturned [long-running operation][google.longrunning.Operation]\ncan be used to track the progress of preparing the new\ninstance. The instance name is assigned by the caller. If the\nnamed instance already exists, `CreateInstance` returns\n`ALREADY_EXISTS`.\n\nImmediately upon completion of this request: \n\n* The instance is readable via the API, with all requested attributes\nbut no allocated resources. Its state is `CREATING`.\n\nUntil completion of the returned operation: \n\n* Cancelling the operation renders the instance immediately unreadable\nvia the API.\n* The instance can be deleted.\n* All other attempts to modify the instance are rejected.\n\nUpon completion of the returned operation: \n\n* Billing for all successfully-allocated resources begins (some types\nmay have lower than the requested levels).\n* Databases can be created in the instance.\n* The instance's allocated resource levels are readable via the API.\n* The instance's state becomes `READY`.\n\nThe returned [long-running operation][google.longrunning.Operation] will\nhave a name of the format `<instance_name>/operations/<operation_id>` and\ncan be used to track creation of the instance.  The\n[metadata][google.longrunning.Operation.metadata] field type is\n[CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata].\nThe [response][google.longrunning.Operation.response] field type is\n[Instance][google.spanner.admin.instance.v1.Instance], if successful.",
      "file": "InstanceAdminClient/CreateInstance/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "CreateInstance",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.CreateInstance",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.CreateInstanceRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "CreateInstanceOperation",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "CreateInstance",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 58,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_CreateInstanceConfig_sync",
      "title": "spanner CreateInstanceConfig Sample",
      "description": "CreateInstanceConfig creates an instance config and begins preparing it to be used. The\nreturned [long-running operation][google.longrunning.Operation]\ncan be used to track the progress of preparing the new\ninstance config. The instance config name is assigned by the caller. If the\nnamed instance config already exists, `CreateInstanceConfig` returns\n`ALREADY_EXISTS`.\n\nImmediately after the request returns: \n\n* The instance config is readable via the API, with all requested\nattributes. The instance config's\n[reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]\nfield is set to true. Its state is `CREATING`.\n\nWhile the operation is pending: \n\n* Cancelling the operation renders the instance config immediately\nunreadable via the API.\n* Except for deleting the creating resource, all other attempts to modify\nthe instance config are rejected.\n\nUpon completion of the returned operation: \n\n* Instances can be created using the instance configuration.\n* The instance config's\n[reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]\nfield becomes false. Its state becomes `READY`.\n\nThe returned [long-running operation][google.longrunning.Operation] will\nhave a name of the format\n`<instance_config_name>/operations/<operation_id>` and can be used to track\ncreation of the instance config. The\n[metadata][google.longrunning.Operation.metadata] field type is\n[CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].\nThe [response][google.longrunning.Operation.response] field type is\n[InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if\nsuccessful.\n\nAuthorization requires `spanner.instanceConfigs.create` permission on\nthe resource\n[parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].",
      "file": "InstanceAdminClient/CreateInstanceConfig/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "CreateInstanceConfig",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.CreateInstanceConfig",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.CreateInstanceConfigRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "CreateInstanceConfigOperation",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "CreateInstanceConfig",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 58,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_DeleteInstance_sync",
      "title": "spanner DeleteInstance Sample",
      "description": "DeleteInstance deletes an instance.\n\nImmediately upon completion of the request: \n\n* Billing ceases for all of the instance's reserved resources.\n\nSoon afterward: \n\n* The instance and *all of its databases* immediately and\nirrevocably disappear from the API. All data in the databases\nis permanently deleted.",
      "file": "InstanceAdminClient/DeleteInstance/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "DeleteInstance",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.DeleteInstance",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.DeleteInstanceRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "DeleteInstance",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 51,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_DeleteInstanceConfig_sync",
      "title": "spanner DeleteInstanceConfig Sample",
      "description": "DeleteInstanceConfig deletes the instance config. Deletion is only allowed when no\ninstances are using the configuration. If any instances are using\nthe config, returns `FAILED_PRECONDITION`.\n\nOnly user managed configurations can be deleted.\n\nAuthorization requires `spanner.instanceConfigs.delete` permission on\nthe resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].",
      "file": "InstanceAdminClient/DeleteInstanceConfig/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "DeleteInstanceConfig",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.DeleteInstanceConfig",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.DeleteInstanceConfigRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "DeleteInstanceConfig",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 51,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_GetIamPolicy_sync",
      "title": "spanner GetIamPolicy Sample",
      "description": "GetIamPolicy gets the access control policy for an instance resource. Returns an empty\npolicy if an instance exists but does not have a policy set.\n\nAuthorization requires `spanner.instances.getIamPolicy` on\n[resource][google.iam.v1.GetIamPolicyRequest.resource].",
      "file": "InstanceAdminClient/GetIamPolicy/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetIamPolicy",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.GetIamPolicy",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.GetIamPolicyRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*iampb.Policy",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "GetIamPolicy",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_GetInstance_sync",
      "title": "spanner GetInstance Sample",
      "description": "GetInstance gets information about a particular instance.",
      "file": "InstanceAdminClient/GetInstance/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetInstance",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.GetInstance",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.GetInstanceRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*instancepb.Instance",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "GetInstance",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.GetInstance",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_GetInstanceConfig_sync",
      "title": "spanner GetInstanceConfig Sample",
      "description": "GetInstanceConfig gets information about a particular instance configuration.",
      "file": "InstanceAdminClient/GetInstanceConfig/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetInstanceConfig",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.GetInstanceConfig",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.GetInstanceConfigRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*instancepb.InstanceConfig",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "GetInstanceConfig",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_ListInstanceConfigOperations_sync",
      "title": "spanner ListInstanceConfigOperations Sample",
      "description": "ListInstanceConfigOperations lists the user-managed instance config [long-running\noperations][google.longrunning.Operation] in the given project. An instance\nconfig operation has a name of the form\n`projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.\nThe long-running operation\n[metadata][google.longrunning.Operation.metadata] field type\n`metadata.type_url` describes the type of the metadata. Operations returned\ninclude those that have completed/failed/canceled within the last 7 days,\nand pending operations. Operations returned are ordered by\n`operation.metadata.value.start_time` in descending order starting\nfrom the most recently started operation.",
      "file": "InstanceAdminClient/ListInstanceConfigOperations/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListInstanceConfigOperations",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigOperations",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.ListInstanceConfigOperationsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "OperationIterator",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "ListInstanceConfigOperations",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigOperations",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_ListInstanceConfigs_sync",
      "title": "spanner ListInstanceConfigs Sample",
      "description": "ListInstanceConfigs lists the supported instance configurations for a given project.",
      "file": "InstanceAdminClient/ListInstanceConfigs/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListInstanceConfigs",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.ListInstanceConfigs",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.ListInstanceConfigsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "InstanceConfigIterator",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "ListInstanceConfigs",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_ListInstances_sync",
      "title": "spanner ListInstances Sample",
      "description": "ListInstances lists all instances in the given project.",
      "file": "InstanceAdminClient/ListInstances/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "ListInstances",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.ListInstances",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.ListInstancesRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "InstanceIterator",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "ListInstances",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.ListInstances",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 60,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_SetIamPolicy_sync",
      "title": "spanner SetIamPolicy Sample",
      "description": "SetIamPolicy sets the access control policy on an instance resource. Replaces any\nexisting policy.\n\nAuthorization requires `spanner.instances.setIamPolicy` on\n[resource][google.iam.v1.SetIamPolicyRequest.resource].",
      "file": "InstanceAdminClient/SetIamPolicy/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "SetIamPolicy",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.SetIamPolicy",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.SetIamPolicyRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*iampb.Policy",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "SetIamPolicy",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_TestIamPermissions_sync",
      "title": "spanner TestIamPermissions Sample",
      "description": "TestIamPermissions returns permissions that the caller has on the specified instance resource.\n\nAttempting this RPC on a non-existent Cloud Spanner instance resource will\nresult in a NOT_FOUND error if the user has `spanner.instances.list`\npermission on the containing Google Cloud Project. Otherwise returns an\nempty set of permissions.",
      "file": "InstanceAdminClient/TestIamPermissions/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "TestIamPermissions",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.TestIamPermissions",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.TestIamPermissionsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "*iampb.TestIamPermissionsResponse",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "TestIamPermissions",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_UpdateInstance_sync",
      "title": "spanner UpdateInstance Sample",
      "description": "UpdateInstance updates an instance, and begins allocating or releasing resources\nas requested. The returned [long-running\noperation][google.longrunning.Operation] can be used to track the\nprogress of updating the instance. If the named instance does not\nexist, returns `NOT_FOUND`.\n\nImmediately upon completion of this request: \n\n* For resource types for which a decrease in the instance's allocation\nhas been requested, billing is based on the newly-requested level.\n\nUntil completion of the returned operation: \n\n* Cancelling the operation sets its metadata's\n[cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time],\nand begins restoring resources to their pre-request values. The\noperation is guaranteed to succeed at undoing all resource changes,\nafter which point it terminates with a `CANCELLED` status.\n* All other attempts to modify the instance are rejected.\n* Reading the instance via the API continues to give the pre-request\nresource levels.\n\nUpon completion of the returned operation: \n\n* Billing begins for all successfully-allocated resources (some types\nmay have lower than the requested levels).\n* All newly-reserved resources are available for serving the instance's\ntables.\n* The instance's new resource levels are readable via the API.\n\nThe returned [long-running operation][google.longrunning.Operation] will\nhave a name of the format `<instance_name>/operations/<operation_id>` and\ncan be used to track the instance modification.  The\n[metadata][google.longrunning.Operation.metadata] field type is\n[UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata].\nThe [response][google.longrunning.Operation.response] field type is\n[Instance][google.spanner.admin.instance.v1.Instance], if successful.\n\nAuthorization requires `spanner.instances.update` permission on\nthe resource [name][google.spanner.admin.instance.v1.Instance.name].",
      "file": "InstanceAdminClient/UpdateInstance/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateInstance",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.UpdateInstance",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.UpdateInstanceRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "UpdateInstanceOperation",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "UpdateInstance",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 58,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "spanner_v1_generated_InstanceAdmin_UpdateInstanceConfig_sync",
      "title": "spanner UpdateInstanceConfig Sample",
      "description": "UpdateInstanceConfig updates an instance config. The returned\n[long-running operation][google.longrunning.Operation] can be used to track\nthe progress of updating the instance. If the named instance config does\nnot exist, returns `NOT_FOUND`.\n\nOnly user managed configurations can be updated.\n\nImmediately after the request returns: \n\n* The instance config's\n[reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]\nfield is set to true.\n\nWhile the operation is pending: \n\n* Cancelling the operation sets its metadata's\n[cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time].\nThe operation is guaranteed to succeed at undoing all changes, after\nwhich point it terminates with a `CANCELLED` status.\n* All other attempts to modify the instance config are rejected.\n* Reading the instance config via the API continues to give the\npre-request values.\n\nUpon completion of the returned operation: \n\n* Creating instances using the instance configuration uses the new\nvalues.\n* The instance config's new values are readable via the API.\n* The instance config's\n[reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]\nfield becomes false.\n\nThe returned [long-running operation][google.longrunning.Operation] will\nhave a name of the format\n`<instance_config_name>/operations/<operation_id>` and can be used to track\nthe instance config modification.  The\n[metadata][google.longrunning.Operation.metadata] field type is\n[UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].\nThe [response][google.longrunning.Operation.response] field type is\n[InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig], if\nsuccessful.\n\nAuthorization requires `spanner.instanceConfigs.update` permission on\nthe resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].",
      "file": "InstanceAdminClient/UpdateInstanceConfig/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "UpdateInstanceConfig",
        "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient.UpdateInstanceConfig",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "instancepb.UpdateInstanceConfigRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "UpdateInstanceConfigOperation",
        "client": {
          "shortName": "InstanceAdminClient",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdminClient"
        },
        "method": {
          "shortName": "UpdateInstanceConfig",
          "fullName": "google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig",
          "service": {
            "shortName": "InstanceAdmin",
            "fullName": "google.spanner.admin.instance.v1.InstanceAdmin"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 58,
          "type": "FULL"
        }
      ]
    }
  ]
}