internal/generated/snippets/iam/apiv1/snippet_metadata.google.iam.v1.json

{
  "clientLibrary": {
    "name": "cloud.google.com/go/iam/apiv1",
    "version": "0.10.0",
    "language": "GO",
    "apis": [
      {
        "id": "google.iam.v1",
        "version": "v1"
      }
    ]
  },
  "snippets": [
    {
      "regionTag": "iam-meta-api_v1_generated_IAMPolicy_GetIamPolicy_sync",
      "title": "iam-meta-api GetIamPolicy Sample",
      "description": "GetIamPolicy gets the access control policy for a resource.\nReturns an empty policy if the resource exists and does not have a policy\nset.",
      "file": "IamPolicyClient/GetIamPolicy/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "GetIamPolicy",
        "fullName": "google.iam.v1.IamPolicyClient.GetIamPolicy",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.GetIamPolicyRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "iampb.Policy",
        "client": {
          "shortName": "IamPolicyClient",
          "fullName": "google.iam.v1.IamPolicyClient"
        },
        "method": {
          "shortName": "GetIamPolicy",
          "fullName": "google.iam.v1.IAMPolicy.GetIamPolicy",
          "service": {
            "shortName": "IAMPolicy",
            "fullName": "google.iam.v1.IAMPolicy"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "iam-meta-api_v1_generated_IAMPolicy_SetIamPolicy_sync",
      "title": "iam-meta-api SetIamPolicy Sample",
      "description": "SetIamPolicy sets the access control policy on the specified resource. Replaces any\nexisting policy.\n\nCan return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.",
      "file": "IamPolicyClient/SetIamPolicy/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "SetIamPolicy",
        "fullName": "google.iam.v1.IamPolicyClient.SetIamPolicy",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.SetIamPolicyRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "iampb.Policy",
        "client": {
          "shortName": "IamPolicyClient",
          "fullName": "google.iam.v1.IamPolicyClient"
        },
        "method": {
          "shortName": "SetIamPolicy",
          "fullName": "google.iam.v1.IAMPolicy.SetIamPolicy",
          "service": {
            "shortName": "IAMPolicy",
            "fullName": "google.iam.v1.IAMPolicy"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    },
    {
      "regionTag": "iam-meta-api_v1_generated_IAMPolicy_TestIamPermissions_sync",
      "title": "iam-meta-api TestIamPermissions Sample",
      "description": "TestIamPermissions returns permissions that a caller has on the specified resource.\nIf the resource does not exist, this will return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operation is designed to be used for building permission-aware\nUIs and command-line tools, not for authorization checking. This operation\nmay “fail open” without warning.",
      "file": "IamPolicyClient/TestIamPermissions/main.go",
      "language": "GO",
      "clientMethod": {
        "shortName": "TestIamPermissions",
        "fullName": "google.iam.v1.IamPolicyClient.TestIamPermissions",
        "parameters": [
          {
            "type": "context.Context",
            "name": "ctx"
          },
          {
            "type": "iampb.TestIamPermissionsRequest",
            "name": "req"
          },
          {
            "type": "...gax.CallOption",
            "name": "opts"
          }
        ],
        "resultType": "iampb.TestIamPermissionsResponse",
        "client": {
          "shortName": "IamPolicyClient",
          "fullName": "google.iam.v1.IamPolicyClient"
        },
        "method": {
          "shortName": "TestIamPermissions",
          "fullName": "google.iam.v1.IAMPolicy.TestIamPermissions",
          "service": {
            "shortName": "IAMPolicy",
            "fullName": "google.iam.v1.IAMPolicy"
          }
        }
      },
      "origin": "API_DEFINITION",
      "segments": [
        {
          "start": 18,
          "end": 53,
          "type": "FULL"
        }
      ]
    }
  ]
}