Object Storage Service:put-bucket-referer

Observações

Por padrão, a conta Alibaba Cloud tem permissão para definir listas de permissões e de bloqueios de hotlinking em um Bucket. Para executar essa operação com um usuário RAM ou via STS, você deve ter a permissão oss:PutBucketReferer. Para mais detalhes, consulte Grant a custom policy.

Formato do comando

ossutil api put-bucket-referer --bucket value --referer-configuration value [flags]

--referer-configuration

A opção --referer-configuration aceita sintaxe XML e JSON. Se o valor incluir o prefixo file://, o sistema lerá a configuração diretamente de um arquivo.

• Sintaxe XML:

  <RefererConfiguration>
    <TruncatePath>boolean</TruncatePath>
    <RefererList>
      <Referer>string</Referer>
    </RefererList>
    <RefererBlacklist>
      <Referer>string</Referer>
    </RefererBlacklist>
    <AllowEmptyReferer>boolean</AllowEmptyReferer>
    <AllowTruncateQueryString>boolean</AllowTruncateQueryString>
  </RefererConfiguration>

• Sintaxe JSON:

  {
    "AllowEmptyReferer": boolean,
    "AllowTruncateQueryString": boolean,
    "TruncatePath": boolean,
    "RefererList": {
      "Referer": ["string", ...]
    },
    "RefererBlacklist": {
      "Referer": ["string", ...]
    }
  }

Exemplos de uso

Os exemplos a seguir mostram como configurar listas de permissões e de bloqueios de acesso no nível do Bucket examplebucket.

• Com um arquivo de configuração XML, use o seguinte conteúdo em referer-configuration.xml:

  <?xml version="1.0" encoding="UTF-8"?>
  <RefererConfiguration>
      <AllowEmptyReferer>false</AllowEmptyReferer>
      <AllowTruncateQueryString>true</AllowTruncateQueryString>
      <TruncatePath>true</TruncatePath>
      <RefererList>
          <Referer>http://www.aliyun.com</Referer>
          <Referer>https://www.aliyun.com</Referer>
          <Referer>http://www.*.com</Referer>
          <Referer>https://www.?.aliyuncs.com</Referer>
      </RefererList>
      <RefererBlacklist>
          <Referer>http://www.refuse.com</Referer>
          <Referer>https://*.hack.com</Referer>
          <Referer>http://ban.*.com</Referer>
          <Referer>https://www.?.deny.com</Referer>
      </RefererBlacklist>
  </RefererConfiguration>

Execute o comando abaixo:

ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.xml

• Com um arquivo de configuração JSON, use o seguinte conteúdo em referer-configuration.json:

  {
      "AllowEmptyReferer": "false",
      "AllowTruncateQueryString": "true",
      "TruncatePath": "true",
      "RefererList": {
          "Referer": [
              "http://www.aliyun.com",
              "https://www.aliyun.com",
              "http://www.*.com",
              "https://www.?.aliyuncs.com"
          ]
      },
      "RefererBlacklist": {
          "Referer": [
              "http://www.refuse.com",
              "https://*.hack.com",
              "http://ban.*.com",
              "https://www.?.deny.com"
          ]
      }
  }

  Execute o comando correspondente:

  ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.json

• Para informar os parâmetros de configuração diretamente em formato JSON na linha de comando, execute:

  ossutil api put-bucket-referer --bucket examplebucket --referer-configuration "{\"AllowEmptyReferer\":\"false\",\"AllowTruncateQueryString\":\"true\",\"TruncatePath\":\"true\",\"RefererList\":{\"Referer\":[\"http://www.aliyun.com\",\"https://www.aliyun.com\",\"http://www.*.com\",\"https://www.?.aliyuncs.com\"]},\"RefererBlacklist\":{\"Referer\":[\"http://www.refuse.com\",\"https://*.hack.com\",\"http://ban.*.com\",\"https://www.?.deny.com\"]}}"